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NEWDOS AND BASIC MODS 

DOS NOMENCLATURE AND STRUCTURE 

REDUCED -SIZE NEUDOS 

COMPATIBLE U/TRSDOS FILES & VICE VERSA 

BASIC ONE-STEP ENTRY 

BASIC LIST* EDIT? DELETE ABBREVIATIONS 

BASIC CMD'XX" FOR DOS ROUTINES 

BASIC SCROLLING COMMANDS 

BASIC OPEN'E't ADD TO SEQUENTIAL FILES 

BASIC ENTRY CORRECTION OF SHIFT ERRORS 

COPY? ON ONE DRIVE* NEW BACKUP* ETC, 

D I S K D U M P I VIDEO - R - P R I N T E R f : ' T 1 N 

FORMAT IMPROVEMENTS 

KEYBOARD DEBOUNCE 

REFt VARIABLES CROSS REFERENCING OPTIONS 

RENUMt BASIC LINES RENUMBERING OPTIONS 
SCREEN-PRINT ( JKL OPTION) ON LINE PRINTEI 

DIRCHECK? TEST AND LIST DISK DIRECTORY 

DISASSEMS MACHINE-CODE DISASSEMBLER (Z 30) 25 

EDTASM IMPROVEMENTS* TAPE & DISK I/O 22 

LEVEL I IN LEVEL II (BASICI & LViDSKSL ) 23 

LMOFFSETt MACHINE CODE TAPE/DISK TRANSFERS 28-30 

SUPERZAPi DISPLAY/PRINT/MODIFY MEM & DISKS 30-32 



USE OF THE FOLLOWING PROGRAMS WILL REQUIRE PURCHASE OF 
RADIO SHACK'S TRSDOS DISK OPERATING SYSTEM* V,2,l OR LATER, 
THE EDTASM MODIFICATIONS IN NEWDOST WILL REQUIRE PURCHASE 
OF THE RADIO SHACK EDITOR/ASSEMBLER PACKAGE, 

DO NOT COPY THIS SOFTWARE FOR OTHERS •■- RECOMMEND ITS PURCHASE! 
PIRATED SOFTWARE REDUCES THE RETURN TO THOSE WHO WRITE AND 
MARKET THE BEST PROGRAMS* AND ULTIMATELY DEPRIVES YOU OF 
FURTHER WORKS FROM YOUR FAVORITE AUTHORS, 
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5 NEWDOS+ INFORMATION - 03/15/79 

THEREIN ARE COMMENTS ON THE CHANGES MADE TO THE TRS-80 DOS SYSTEM BY 

5APPARAT? INC.? 6000 E.EVANS AVE.* DENVER CO 30222 (303/758-7275) 

JMINOR EDITING AND BROCHURE PREPARATION BY 

5MILLER MICROCOHPUTER SERVICES? 61 LAKE SHORE RD.i NATICK MA 01760 (617/653-6136) 

? 
i 

5 ************************ 

5 WITH THESE CHANGES? APPARAT DOES NOT PROVIDE COPIES OR EXTRACTS OF THE ORIGINAL 

^DOCUMENTATION FOR BASIC? FOR DOS OR FOR THE EDIT OR- ASSEMBLER, THE ORIGINAL 

^RELEASES OF THESE PROGRAMS ARE COPYRIGHTED BY OTHERS AND SOLD BY RADIO 

i SHACK. THE USERS/BUYERS OF THIS UPDATED SYSTEM ARE ASSUMED TO HAVE PURCHASED 

?THESE ORIGINAL PROGRAMS FROM RADIO SHACK? THEREBY OBTAINING THE ORIGINAL 

^DOCUMENTATION AND IMPLICITLY FAYING 



5APP 



00100 

00110 

00120 

00130 

00140 

00150 

00160 

00170 

00180 

00190 

00200 

00210 

00220 

00230 _ 

00240 J THE ROYALTIES DUE. APPARAT'S REFUSAL TO SUPPLY COPIES 

00250 J THE ORIGINAL DOCUMENTATION IS ITS SOLE EFFORT TO ASSUH 

00260 J BEING PAID. 

00270 

00280 

00290 

00300 

00310 

00320 

00330 

00340 

00350 

00360 

00370 

00380 

00390 

00400 

00410 

00420 

00430 

00440 

00450 

00460 

00470 

00480 

00490 

00500 

00510 



ARAT? 
1 



3. 



AN 



6. 



Ok EXTRACTS OF 
i ROYALTIES ARE 



INC. 
PROVIDES THIS SYSTEM SOLELY IN AN 'AS IS' CONDITION. 
DOES HOT GUARANTEE THAT? AND PROBABLY DOES NOT KNOW WHETHER? 

PARTICULAR PROGRAM/APPLICATION WILL FUNCTION PROPERLY OR 

SATISFACTORILY WITH THIS SYSTEM. 
REQUIRES THAT THE USER THOROUGHLY TEST THIS SYSTEM BEFORE 

USING IT WITH VALUED DATA OR APPLICATIONS, 
IS NOT RESPONSIBLE FOR DAMAGES CAUSED BY USE OF THIS SYSTEM. 
DOES NOT PROVIDE MAINTENANCE? UPGRADE OR CONSULTATION SERVICES 

AS PART OF THIS OFFERING. 
HOPES THE SYSTEM INFORMATION PROVIDED HEREIN IS ACCURATE BUT 

CANNOT GUARANTEE IT, 



} *********************** 



SEACH CHANGE IS HEADED BY A LINE OF ASTERISKS? 



ING THE CHANGE ID, 



THE HANDLING OF THE DIRECTORIES IS ESSENTIALLY THE SAME AS IN DOS 2.1. 



00520 

00530 

00540 

00550 

00560 

00570 

00580 

00590 

00600 

00610 

00620 

00630 

00640 

00650 

00660 

00670 

00680 

00690 
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SYSTEM CONSISTS OF THE FOLLOWING MODULES? WHICH 
ARE SIMPLY THE ORIGINAL DOS 2,1 MODULES WITH CORF 



IF NOT NOTED AS 

ECTION3 AND ENHANCEMENTS. 



0. 
1, 



BOOT/SYS 
SYSO/SYS 



3. 
4. 
5. 

6. 
7, 
8. 

9. 

10 



SYS1/SYS 
SYS2/SYS 
SYS3/SYS 

SYS4/SYS 
SYS5/SYS 
SYS6/SYS 
FORMAT/CMD 
. COPY/CMD 



11, BASIC/CMD 

12. SYS13/SYS 



GRANULES, DISKETTE DIRECTORY, 

GRANULE. BOOTSTRAPS THE SYSTEM, 

GRANULE, RESIDENT MODULE. HANDLES DISK I/O? 

CLOCK INTERRUPTS? LOAD OF SYSTEM OVERLAY 

MODULES? ETC. 
GRANULE. INTERROGATES DOS COMMANDS. 
GRANULE. OPEN EXECUTOR AND OTHER FUNCTIONS. 
GRANULE. HANDLES CLOSE AND KILL. CONT 

FORMATTING CODE. 
GRANULE. DISPLAYS SYSTEM ERROR MSGS, 
GRANULE, 'DEBUG' AND CMD"D" EXECUTOR, 
GRANULES. DOS COMMAND EXECUTOR? EXCEPT 
GRANULES, 'FORMAT' EXECUTOR, 
GRANULE. NEW MODULE. EXECUTES DOS COPY COMMAND WITH 

SINGLE-DRIVE AND 'BACKUP' CAPABILITIES, 
GRANULES. EXECUTES BASIC'S LEVEL III FUNCTIONS, 
GRANULE. NEW MODULE. DISPLAYS BASIC'S ERROR 



COPY'S 



COPY AND DEBUG. 



00700 

00710 

00720 

00730 

00740 

00750 

00760 

00770 

00780 

00790 

00300 

00310 

00820 

00830 

00840 

00850 

00860 

00870 

00880 

00390 

00900 

00910 

00920 

00930 

00940 

00950 

00960 

00970 

00980 

00990 

01000 

01010 

01020 

01030 

01040 

01050 

01060 

01070 

01080 

01090 

01100 

onio 

01120 
01130 
01140 
01150 
01160 
01170 
01180 
01190 
01200 
01210 
01220 
01230 
01240 
01250 
01260 
01270 
01280 
01290 



? MESSAGES. MUSI BE IN SYSTEM WHENEVER BASIC 

I 13 ACTIVE. 

? 13. SYS12/SYS 1 GRANULE. NEW MODULE. EXECUTES BASIC DIRECT COMMAND 

? 'REF'. NEED NOT BE IN SYSTEM IF REF WILL 

i NEVER BE EXECUTED. 

5 14. SYS11/SYS 1 GRANULE. NEW MODULE. EXECUTES BASIC DIRECT COMMAND 

I 'RENUM'. NEED NOT BE IN SYSTEM IF RENUM WILL 

5 NEVER BE EXECUTED. 

i 15. DIRCHECK/CMD 3 GRANULES. NEW MODULE. MAKES CHECKS AND LIST/ 

5 — PRINTS DIRECTORY CONTENTS. 

s 16. EDTASM/CMD 5 GRANULES. EDITOR-ASSEMBLER FOR 2-80 CODE, SOURCE 

i AND OBJECT CODE FROM/TO DISK OR TAPE. 

» 17, BISOUMP/BAS 2 GRANULES. DUMPS DISK FILES TO DISPLAY OR LINE PRIMER. 

? 18. BASIC1/CMD PROVIDES A LEVEL-I-IN-LEVEL-II CAPABILITY. 

I 19, LViDSKSL/CMD ALLOWS STORAGE AND RETRIEVAL OF LEVEL I PROGRAMS 

i BUT NOT DATA TO/FROM DISK, 

f 20. SUPER2AP/BAS BASIC PROGRAM THAT ALLOWS INSPECTION AND MODIFIER! ION 

J OF EITHER DISK OR MAIN MEMORY. DISK OPS ARE NOT 

I FILE ORIENTED, 

i 21, SUPERZAP/COM BASIC PROGRAM SERVING AS SUPER2AP HQCUMENTA i ION. 

ittttUtUt REDUCED-SIZE OPERATING SYSTEMS CAN BE CREATED BY 'COPY'ING FULL NEWDUS 
^DISKETTE? THEN 'KILL'ING UNWANTED FILES (SEE FOLLOWING), 

? 

? A MINIMUM SYSTEM TO HANDLE OPEN'S AND CLOSE'S WILL CONSIST OF 10 GRANULES 

5 (BOOT* DIRv SYS0-SYS4) 

MP DEBUG TO BE USED? ADD SYS5. 

»IF DOS COMMANDS (DIR? CLOCK* APPEND* DATE? ETC) TO BE EXECUIED? ADD 8YS6 

J(SYS5 NOT REQUIRED), 

fIF DOS COMMAND COPY TO BE EXECUTED? ADD COPY/CMD, (SYS5? SYS6 NOT REQUIRED) 



?IF FORMAT TO BE EXECUTED? ADD FORMAT/CMD. (SYS5? 



COPY NOT REQUIRED) 



J IF BASIC TO BE ENTERED? ADD BASIC/CMD AND SYS13. ONCE BASIC IS LOADED? 
JIT DOES NOT HAVE TO REMAIN PART OF THE SYSTEM DISKETTE CONTENTS (BUT 
JSYS13 DOES). SYS5 NOT NEEDED IF CHD"D" NOT USED, SYS6? COPY? FORMAT NOT 
i NEEDED UNLESS ASSOCIATED COMMANDS ARE EXECUTED VIA CMD"XX" FUNCTION. 
J IF BASIC DIRECT COMMAND REF TO BE EXECUTED? ADD SYS12. 



5 IF BASIC DIRECT COMMAND RENUM TO BE EXECUTE! 



i , At tn L 



SYS11, 



? BASIC? COPY? FORMAT DO NOT HAVE 10 RESIDE ON 1HE SYSTEM DISKETTE ON 
? DRIVE 0? BY APPENDING THE DRIVE * (IE 
J THE MODULE CAN BE TAKEN FROM THE DISK: 



C0PY;2) 10 THE COMMAND NAME 

i 7 c. n !.l "j u i: a [.■■ c. r T Ftp Vi 1 1 p 1 1 1 r 



:UU THE SYSTEM CHANGES HEREIN Mi 



? ORIGINAL DOS 2,1 SYSTEM, NO 
» COPY/CMD? BASIC/CMD OR F0RHA1 



E THIS SY: 
THIS SYST 



riHi\ 
i i u i' o u u u > 
/CMD ) 

ULES FROM 
i ANY OTHER SYSTEM? OR VICE-VERSA. CHANCING SYS 



I EM INCOMPATIBLE WITH THE 
M \ S Y b 'a Y S 6 ? S Y S 1 i - 'd Y b 1 6 ? 



THE ORIGINAL DOS 2.1 OR 

I EMS MUSi BE ACCOMPLISHED VIA 



?WH£N COPYING FILES INTO OR OUT OF THIS SYSTEM? THE SOURCE AND/OR THE DESTINATION 

?FILE MAY RESIDE ON AN ALIEN SYSTEM DISKETTE PROVIDED ONE OF THE FOLLOWING EXISTS; 

» 1. THE ALIEN SYSTEM DISKETTE IS NEVER MOUNTED ON DRIVE ZERO. 

i 2. THE COPY COMMAND HAS THE SOURCE FILESPEC PRECEDED BY A t , 

? THE ORIGINAL DOS 2,1 'BACKUP'' MODULE WILL WORK WITH THIS SYSTEM. HOWEVER? 

J AN OPTION OF THIS SYSTEM'S COPY ACCOMPLISHES ESSEN! TALLY THE SAME THING. 

ittntttu 



J USE OF 'COPY' IS DISCUSSED IN CHANGE * 040. 
JUSE OF 'REF' IS DISCUSSED IN CHANGE # 045, 



ITS FORMAT #5 REPLACES 'BACKUP'. 



01300 

01310 

01320 

01330 

01340 

01350 

01360 

01370 

01380 

01390 

01400 

01410 

01420 

01430 

01440 

01450 

01460 

01470 

01480 

01490 

01500 

01510 

01520 

01530 

01540 

01550 

01560 

01570 

01580 

01590 

01600 

01610 

01620 

01630 

01640 

01650 

01660 

01670 

01680 

01690 

01700 

01710 

01720 

01730 

01740 

01750 

01760 

01770 

01780 

01790 

01800 

01810 

01820 

01830 

01840 

01850 

01860 

01870 

01880 

01890 



5USE OF 'RENUH' IS DISCUSSED IN CHANGE * 046. 

*USE OF 'FORMAT' IS DISCUSSED IN CHANGE * 037. 

5USE OF 'JKL' OPTION IS DISCUSSED IN CHANGE * 017. 

^KEYBOARD DEBOUNCE IS DISCUSSED IN CHANGE * 016. 

*NEU BASIC INVOCATION IS DISCUSSED IN CHANGE # 039. 

^BASIC'S CMD"XX" FUNCTION IS DISCUSSED IN CHANGE # 035. 

5BASIC SCROLLING COMMANDS DISCUSSED IN CHANGE * 031. 

i TRUNCATED BASIC LIST. EDIT AND DELETE COMMANDS ARE DISCUSSED IN CHANGES 

? t 047 AND 031. 

IBASIC OPEN"E" IS DISCUSSED IN CHANGE * 019. 

*'DISKDUMP/BAS' IMPROVEMENTS DISCUSSED IN CHANGE £ 043. 

S'EDTASN/CND' IMPROVEMENT DISCUSSED IN CHANGE # 049. 

*LEVEL I IN LEVEL II OPERATION. CHANGES * 050 AND 051. 

? 



* 
I THE 



FOLLOWING SHOULD BE NOTED*. 

1. THIS SYSTEM DOES HOT ADVANCE DATE Al 2400. 

2. ALL PASSWORD PROTECTION IS DISABLED. SEE LHAMGE 4003 FOR 

PASSWORD ENABLE/DISABLE INSTRUCT IONS. 

3. DEVICE COMMAND IS DISABLED. 

4. ALL BASIC WRITES TO DISK? VIA PRINT AND PU" 
READ, USER HAS NO CONTROL OF THIS. 



UNHANDS ARE VALIDITY 



ALL BASIC PROGRAMS 'SAVED' TO DISK ARE VALIDITY REAI 



i ,'t_ ,• ■. i i 



6. ALL FILES DUPLICATED BY 'COPY' ARE VALIDF 

7. 'APPEND' NOW WORKS* 

3. FILE EOF'S ARE HANDLED CORRECTLY. 

9. BASIC'S 'LOC COMMAND NOW WORKS PROPERLY. 

10. DOS CMD 'VERIFY' NOW WORKS PROPERLY. 

11. ALL SYSTEM DIRECTORY WRITES ARE NOW VALIDITY READ. 

12. BASIC 'LOAD' AND 'SAVE' RUN 0-30% FASTER* DEPENDING UPON 

PROGRAM SIZE. 

13. DUE TO CORRECTIONS IN SY33* A NUMBER OF DIRECTORY CLOBBERING 

SITUATIONS HAVE BEEN ELIMINATED. 

14. DISK SPACE ALLOCATION IS 1 GRANULE INCREMENTS s 
THIS INCREASES 



t u •::;• t p a 



D 



np 



1 



WRITE OVERHEAD BUT ALLOWS LAST GRANULE ON DISKE 

; :AM TO 



!TE 



TO 
TO 



USED 



BASIC'S OPEN"E" FUNCTION ALLOWS A BASIC PF 
EXISTING SEQUENTIAL FILE, 
16. THE DISK BACKUP FUNCTION OF SUPERZAP ALLOWS INFINITE RETRY 

TO RECOVER INFORMATION FROM A BAD SECTOR WHEN -BACKUP' OR 
COPY (FULL DISKETTE OPTION) FAIL, IF l HAT STILL FAILS* THEN 
BYPASS THE BAD SECTOR(S) AND USE SUPERZAP' S 'SCQPY' OPTION 
TO RECOVER AS MUCH AS POSSIBLE OF THE BAD SECTOR* MOVING IT 
TO A DIFFERENT SECTOR WHERE IT POSSIBLY CAN BE CORRECTED, 
THE 'JKL' OPTION ALLOWS THE FULL DISPLAY CONTENTS TO BE SENT 
TO THE LINE PRINTER* WITHOUT DISTURBING OR ADDING TO THE 

DISPLAY CONTENTS. 

LEVEL 1-IN-LEVEL2 OPERATION IS AVAILABLE THROUGH 'BASIC1' AND 
'LV1DSKSL' DOS COMMANDS. SEE CHANGES 050 AND 051. 

UNDER OLD DOS* IF NORMAL USER DISK I/O REFERENCES A DRIVE 

WITHOUT A DISKETTE OR WITH DISKETTE IMPROPERLY MOUNTED* THE 
SYSTEM MIGHT HANG. THIS SYSTEM WILL PROBABLY CATCH THE 
CONDITION* THOUGH IT MIGHT TAKE 30 SECONDS. 

THE OCCURRENCE OF 'LOST DATA' DISK ERRORS IS GREATLY REDUCED. 

ON EVERY SECTOR READ/WRITE* THE CLOCK LOSES APPROXIMATELY 
120MS, IF THIS IS IMPORTANT* SEE CHANGE #007. 



17 



IS, 



19. 



20 
21 



f J**************************************************** 



— 5 — 

01900 * DOS NOMENCLATURE AND STRUCTURE J 

01910 * 

01920 * 1. SECTOR UNIT OF 256 BYTES STORED ON DISK. 

01930 i 2. GRANULE UNIT OF 5 SECTORS. THE BASIC UNIT OF DISK STORAGE 

01940 i ALLOCATION. DIRECTORIES KEEP TRACK OF FREE/ASSIGNED DISK SPACE 

01950 5 IN TERMS OF GRANULES. 

01960 i 3. TRACK UNIT OF 10 SECTORS (2 GRANULES)? EQUALS THE * 

01970 i OF DATA BYTES THE DISK READ/WRITE HEAD PASSES OVER ON EACH 

01930 * DISKETTE REVOLUTION. 

01990 5 4. BOOT/SYS A FILE PLACED ON EVERY DISKETTE BY 'FORMAT'. THIS 

02000 I IS THE BOOTSTRAP ROUTINE INVOKED WHEN RESET OR FOWER-ON 

02010 i OCCURS. IT AUTOMATICALLY LOOKS IN THE DIRECTORY FOR 

02020 J SYSO/SYS'S ENTRY. IF PRESENT AND ACTIVE* SYSO/SYS IS LOADED 

02030 * INTO MEMORY AS THE DOS RESIDENT MODULE. OTHERWISE THE 

02040 i SYSTEM HANGS, 

02050 i 5. DIR/SYS A FILE PLACED ON EVERY DISKETTE BY FORMAT , II 

02060 * IS REQUIRED FOR PROPER DOS OPERATION, CURRENTLY 11 CONSISTS 

02070 i OF 10 SECTORS USED AS FOLLOWS: 

02030 i 1. SECTOR (GAT SECTOR) CONTAINS; 

02090 « 1. DISKETTE NAME. (OFFSET = D0-D7 HEX) 

02100 * 2. LATEST CREATION? BACKUP OR COPY DATE. (OFFSET 

02110 i = D8-DF HEX) 

02120 * 3. DISKETTE PASSWORD ENCODE. (OFFSET = CE-CF HEX) 

02130 * 4. DOS 'AUTO-' INFORMATION* (OFFSET EO -FT HEX) 

02140 * 5. TRACK LOCKOUT INFO, OFFSET 60 HEX AND UP FOR 

02150 I AS MANY BYTES AS THE 

02160 * DISKETTE HAS TRACKS. FC HEX VALUE HEANS 

02170 * TRACK NOT LOCKED OUT! FT HEX VALUE MEANS 

021S0 i TRACK IS LOCKED OUT, 

02190 * 6. GRANULE FREE/ASSIGNED STATUS, OFFSET 00 HEX 

02200 i . _ AND UP FOR AS 

02210 * £ r- HftNY BYTES AS THE IiISKET1E - HAS TRACKS, 

02220 * ®~^ *'1 EACH BYTE CONTAINS INFORMATION FOR THE TWO 

02230 I C X. X GRANULES ON THAT TRACK, 

02240 i n tf y 1ST 6 BITS SHOULD ALWAYS =1. 7TH BIT IS 

02250 5 . «: F0R THE 2ND GRANULE OF THE TRACK (SECTORS 0-9), 

02260 i fc * </ THE 8TH Bn IS FQR THE 1ST mmiL 0F ]HL 

02270 5 F V V TRACK (SECTORS 0-4 5, FOR THESE TWO BITS* 

02280 f THE CORRESPONDING GRANULE IS FREE IF THE 

02290 * BIT s.i-j IS ALLOCATED TO A FILE IF = . , '■':-*■ 

02300 * 2, SECTOR 1 (HIT SECTOR) CONTAINS A 1 BYTE HASH CODE FOR 

02310 * EACH ACTIVE DIRECTORY ENTRY (4TH BIT* 1ST BYTE - 1) 

02320 i IN SECTORS 2-9 * THUS ALLOWING RAPID ACCESS TO FILES, 

02330 i THE HASH CODE IS BASED ON THE CONTENTS OF FPDE* 

02340 i BYTES 6-16, 

02350 * THE RELATIVE POSITION IN THE HIT SECTOR OF A 

02360 I DIRECTORY ENTRY'S HASH CODE IS EQUAL TO THAT ENTRY'S 

02370 i DEC, THE OTHER 192 BYTES OF THE SECTOR ARE NOT 

02380 * CURRENTLY USED AND SHOULD ALWAYS = 0. 

02390 I 3, SECTORS 2-9 EACH CONTAIN SPACE FOR EIGHT 32 BYTE 

02400 i DIRECTORY ENTRIES ( FPDE OR FXDE). 1ST TWO ENTRIES 

02410 i • OF EACH SECTOR ARE RESERVED FOR THE SYSTEM, 

02420 5 NORMALLY THE DIRECTORY IS LOCATED ON DISKETTE'S RELATIVE 

02430 i TRACK 11 HEX. 

02440 i 6. FPDE FILE PRIMARY DIRECTORY ENTRY, EACH FILE* WHEN CREATED* 

02450 * IS ASSIGNED A DIRECTORY ENTRY SOMEWHERE IN DIRECTORY SECTORS 

02460 I 2-9. THIS ENTRY CONTAINS; 

02470 5 1. 1ST BYTE* 1ST BIT = 0» INDICATING FPDE* VICE FXDE, 

02480 * 2. 1ST BYTE* 2ND BIT = 1 IF A SYSTEM FILE, 

02490 5 3. 1ST BYTE* 4TH BIT = 1 IF THIS ENTRY IS ASSIGNED TO A 



_ 6 - 



02500 i 

02510 i 

02520 f 

02530 i 

02540 5 

02550 ? 

02560 J 

02570 I 

02580 J 

02590 i 

02600 ? 

02610 ? 

02620 i 

02630 J 

02640 ? 

02650 ? 

02660 ? 

02670 

02680 

02690 

02700 

02710 

02720 

02730 

02740 

02750 

02760 

02770 

02780 

02790 

02800 

02810 

02820 

02830 

02840 

02850 

02860 

02870 

02880 

02890 

02900 

02910 

02920 

02930 

02940 

02950 

02960 

02970 

02980 

02990 

03000 

03010 

03020 

03030 

03040 

03050 

03060 

03070 

03080 

03090 



FILE AND HAS A NON-ZERO HASH CODE IN THE HIT SECTOR. 
THE OFFSET IN THE HIT SECTOR OF THIS ENTRY'S HASH 
CODE = THIS ENTRY'S DEC* 

IF THIS BIT * 0? THE DIRECTORY ENTRY IS AVAILABLE 
FOR REASSIGNMENT? I.E.* IF FIRST HEX DIGIT ON 
SUPERZAP'S DUMP LINE IS 0, 

4. 1ST BYTEs 5TH BIT = 1 IF A FILE HAS THE INVISIBLE ATTRIBUTE* 

5. 1ST BYTE* 6-3TH BITS = PROTECTION LEVEL : 

7 = NO ACCESS. 

6 = EXECUTION ACCESS ONLY. 

5 = READ? EXECUTE ACCESSES 

4 = WRITE? READ? EXECUTE 

3 = (UNUSED) 

2 = RENAME? WRITE? READ? EXECUTE 

1 = KILL? RENAME* WRITE? READ? EXECUTE 

= NO RESTRICTIONS 

6. 2ND BYTE = 0? USE UNKNOWN. 

7. 3RD BYTE = 0? USE UNKNOWN. 

8. 4TH BYTE = 0-255 tND-OF-FILE RELATIVE POSITION IN THE EOF 

SECTOR. 

9. 5TH BYTE = 0-255 LOGICAL RECORD LENGTH, = 256. 

WHEN FILE IS CREATED VIA A 4420H VLCT OR CALL? THE 
VALUE FROM REGISTER B IS STORED HERE. WHEN AN EXISTING 
FILE IS OPENED? EVEN AS A NEW OUTPUT FILE? iHIS VALUE 
IS NOT UPDATED. THIS VALUE IS NEVER USED. THE 
VALUE STORED IN FCB+9 AT OPEN TIKE IS I HAT FROM 
REGISTER B? NOT FROM THE FPDE. 

10. 6TH-13TH BYTES = FILE NAME? PADDED ON RIGHT WITH 

BLANKS IF NECESSARY. 

11. 14TH-16TH BYTES = FILE NAME MODIFIER, PADDED ON RIGHT 

WITH BLANKS AS NECESSARY. 

12. 17TH-18TH BYTES = ENCODE OF UPDATE PASSWORD. 

13. 19TH-20TH BYTES * ENCODE OF ACCESS PASSWORD. 

14. 21ST-22ND BYTES = RELATIVE SECTOR $ WITHIN THE FILE 

OF EOF. HOWEVER? IF THE 4TH BYTE IS NUN- ZERO? 
THIS VALUE IS RELATIVE EOF SECTOR + 1. THIS SYSTEM 
MAINTAINS THE EOF WITHIN THE FPDE COMPATIBLE WITH 
THAT OF TRSDOS 2.1 SO THAT A FILE MAY BE USED 
INTERCHANGEABLY BETWEEN THE TWO SYSTEMS. 
WHEN A FILE IS OPEN? THE EOF VALUE IN 
THE FCB IS MAINTAINED DIFFERENTLY IN THE TWO SYSTEMS. 
15. 23RD-30TH BYTES = FOUR 2 BYTE PAIRS (EXTENT ELEMENTS)? 
EACH SPECIFYING A CONTIGUOUS AREA OF THE DISKETTE 
ASSIGNED TO THIS FILE. THE FORMAT OF AN EXTENT 
ELEMENT ISt 
1. 1ST byte: 

1. 255 = END OF EXTENTS. 

2. 254 = 2ND BYTE CONTAINS THE DEC 

FOR THE NEXT FXDE ASSIGNED 

TO THIS FILE TO CONTAIN ADDITIONAL 

EXTENT INFORMAT ION . 

3. - 34 = RELATIVE TRACK ON DISKETTE FOR 

START OF AREA. IF YOUR DISKETTES 
HAVE MORE THAN 35 TRACKS? THIS VALUE 
CAN COVER - 253 RANGE. 



2ND BYTE (WHEN 1ST BYTE 



54) 



1. LEFT 3 BITS = * GRANULES (0-7) OFFSET 

FROM START OF TRACK TO START OF AREA. 

2. RIGHT 5 BITS = #-1 OF CONTIGUOUS 

GRANULES ASSIGNED TO THIS AREA. 



- 7 



03100 i 

03110 i 

03120 ! 

03130 5 

03140 i 

03150 5 

03160 i 

03170 i 

03180 5 

03190 i 

03200 j 

03210 ? 

03220 i 

03230 i 

03240 

03250 i 

03260 5 

03270 ! 

03280 » 

03290 i 

03300 i 

03310 5 

03320 

03330 

03340 

03350 

03360 i 

03370 ? 

03380 ! 

03390 i 

03400 

03410 i 

03420 

03430 

03440 

03450 

03460 

03470 

03480 

03490 

03500 

03510 

03520 

03530 

03540 

03550 

03560 

03570 

03580 

03590 

03600 

03610 

03620 

03630 

03640 

03650 

03660 

03670 

03680 

03690 



7. FXDE 



16. 31-32ND BYTES CONTAIN AN EXTENT ELEMENT WHOSE 1ST BYTE 
IS EITHER 255 OR 254. 
FILE EXTENDED DIRECTORY ENTRY. WHEN A FILE HAS 



MORE THAN 4 SPACE AREAS ASSIGNED? THE ADDITIONAL 



ELEMENTS ARE CONTAINED IN 
THE FORHAT OF A FXDE IS*. 



FXDE'S ASSIGNED TO THE 



EXTENT 
FILE. 



: 1 TO INDICATE FXDE* VICE FXPE. 

SEE FPDE. 
FOR PREVIOUS FXDE 



9. 



1. 1ST BYTE, 1ST BIT 

2. 1ST BYTE,- 4TH BIT. 

3. 2ND BYTE = DEC FOR PREVIOUS FXDE OR FPDE 

OF THIS FILE. THIS IS A BACKWARD CHAIN. 
THE PREVIOUS ENTRY'' S 31ST BYTE WILL BE 21 
THE 32ND BYTE WILL CONTAIN THE DEC OF "HF 

4. BYTES 3-22 ARE UNUSED AMD SHOULD = 0. 

5. BYTES 23-32 ARE AS DEFINED FOR FPDE. 
EXTENT ELEMENT (SEE FPDE* BYTES 23-30). 
DEC DIRECTORY ENTRY CODE. A ONE BYTE 

SPECIFY ONE OF THE THE 64 DIRECTORY ENTRIES 
SECTORS 2 - 9. THE FORHAT 1S5 
RRROOSSS WHERE 
SSS+2 = RELATIVE SECTOR IN DIRECTORY 
RRR = RELATIVE 32 BYTE DIRECTORY ENTRY 



AND 

FXDE. 



CODE USED TO 
IN DIRECTORY 



w 



10. GAT GRANULE ALLOCATION TABLE, 
SECTOR 0. 

11. HIT HASH INDEX TABLE. REFERS 

12. VICE MEANS -'INSTEAD OF' OR 'IN 

13. FCB FILE CONTROL BLOCK. ALSO 

(INPUT/OUTPUT BLOCK). AT OPEN 
OR 4424H)? THE CALLER PROVIDES 



REFE 



IN i HAT SECTOR. 
RS TO DIRECTORY 



RELATIVE. 



TO DIREC 
PLACE OF 
KNOWN AS 



rORY RELATIVE SECTOR 1, 



S AN 
TIME (CALL TO D 
IN REGISTER DE 



A 32 BYTE MAIN MEMORY AREA FOR USE BY THE 
FILE IS OPEN, THE USER MUST HAVE PLACED i 
THE FCB'S 1ST BYTES? AND CLOSE WILL AIIEHF 



I OB 

OS 4420H 

THE ADDRESS OF 
SYSTEM WHILE THE 
HE FILE- SPEC INTO 
T TO PUT IT 



BACK THERE 
THE 32 

1. 1ST 

2, 2ND 



WHEN DONE. 

BYTE FCB IS'. 

BYTE? 1ST BIT = 

BYTE,- 1ST BIT -■ 

LOGICAL RECORD 

BEING DONE ON 



WHILE THE FILE IS OPEN? THE FORMAT FOR 

1? FILE IS OPEN? = 0? FILE IS CLOSED. 
1? EITHER SINGLE BYTE OPERATIONS OR 
OPERATIONS (REC LENGTH IN 10TH BYTE) 
THIS FILE, 'NEXT' VALUE IS MAINTAINED 



AT THE NEXT BYTE TO BE READ/WRITTEN. 
= 0? SECTOR OPERATIONS? CALLS 10 SYSTEM ARE BY 
FULL 256 BYTE SECTOR. 'NEXT' VALUE IS MAINTAINED 
AT START OF NEXT SECTOR TO BE READ/WRI TTEN , 
THIS BIT IS SET = 1 AT OPEN TIME IF REGISTER B 
NOT = 0. IT IS ALSO SET - 1 WHENEVER ONE OF THE 
ROM (LEVEL II BASIC) SINGLE BYTE READ/WRITE ROUTINES 
ARE CALLED WITH REGISTER DE CONTAINING THE FCB ADDR. 

3. 2ND BYTE? 2ND BIT 

=0. EOF IS BE SET = TO 'NEXT' ON EVERY WRITE OPERATION, 
=1, EOF IS TO BE SET - TO 'NEXT' ONLY FOR THOSE 

WRITE OPERATIONS RESULTING IN 'NEXT' 

EXCEEDING THE OLD EOF. 

4. 2ND BYTE? 3RD BIT 

= 0. BUFFER CONTAINS THE CURRENT SECTOR. 

= 1? BUFFER DOES NOT CONTAIN THE CURRENT SECTOR. 

5. 2ND BYTE? 4TH BIT 

= 0? BUFFER DOES NOT CONTAIN UPDATED DATA NOT 

YET SENT TO THE FILE. 
= 1? BUFFER DOES CON IAIN UPDATED DATA NOT YET 

SEND TO THE FILE. 



AT CLOSE 
BOTH = 1? 



TIME-; IF THIS 
THE RESIDUAL 



BIT AND 2ND BYTE? 1ST BIT 
SECTOR IN THE BUFFER IS 



03700 5 
03710 i 
03720 I 
03730 i 
03740 5 
03750 5 
03760 5 
03770 5 
03780 i 
03790 » 
03800 ? 
03810 J 
03820 i 
03830 J 
03840 5 
03850 5 
03860 ? 
03870 i 
03880 5 
03890 J 
03900 ? 
03910 J 
03920 i 
03930 I 
03940 ,* 
03950 5 
03960 i 
03970 5 
03980 » 
03990 5 
04000 5 
04010 i 
04020 5 
04030 J 
04040 5 
04050 i 
04060 » 
04070 J 
04080 i 
04090 ? 
04100 i 
04110 
04120 
04130 
04140 
04150 
04160 5 
04170 i 
0418O i 
04190 J 
04200 J 
04210 J 
04220 ', 
04230 I 
04240 5 
04250 I 
0426O 5 
04270 5 
04280 I 
04290 5 



AUTOMATICALLY WRITTEN TO DISK, 
6. 2ND BYTE* 6-8TH BITS = PROTECTION CODE (SEE FPDE, 1ST BYTE 

6-8TH BITS) IF PASSWORD CHECKING ENABLED AND 

ACCESS? VICE UPDATE, PASSWORD SPECIFIED IM THE 

FILESF'EC AT OPEN TIME. 
7* 3RD BYTE* SET = AT OPEN TIME, DON'T KNOW WHAT IT'S 

USED FOR, 

8. 4-5TH BYTES CONTAIN THE BUFFER ADDRESS SUPPLIED IN REG HL 

BY CALLER AT OPEN TIME, 

9, 6TH BYTE LOW ORDER BYTE OF 3 BYTE 'NEXT' VALUE. 

THIS IS THE RELATIVE POSITION WITHIN SECTOR VALUE, 
SEE DISCUSSION FOR 11-12TH BYTES BELOW, 

10, 7TH BYTE RELATIVE DRIVE t OF DRIVE CONTAINING DISKETTE 

CONTAINING THE FILE AT OPEN TIME, 

11. 8TH BYTE DEC OF FILE'S FPDE, 

12. 9TH BYTE LOW ORDER BYTE OF EOF, SEE DISCUSSION Of- FCB, 

13-14TH BYTES, 

13, 10TH BYTE 0-256 LOGICAL RECORD LENGTH ( LRL ) FOR 



LOGICAL RECORDS OF THIS FILE, = 256, THIS VALUE 
SUPPLIED IN REGISTER B BY THE CALLER AT OPEN TIME, 
IF NOT = AT OPEN TIME? FCB 1ST BYTEs IS I BIT IS : 
= 1* AND DOS SECTOR READ/WRITE CALLS MUSI CONTAIN 
IN REGISTER HL THE ADDRESS OF THE LOGICAL RECORD TO 
BE MOVED TO THE FCB'S BUFFER (WRITE) OR FILLED FROM 
THE FCB'S BUFFER (READ). 



IS 



El 



14. 11- 



FORM A3 BYTE 
TO BE PROCESSED! 



OPERATIONS ( 



2ND 
BY 



THE ORIGINAL DOS SYSTEM 

HIGH BY 256 ? CAUSING SOME PROBLEMS 
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•12TH BYTES 12THi 11TH AND 5TH BYTES 

RELATIVE OFFSET IN FILE TO THE NEXT BYTE 

EITHER INPUT OR OUT 

BYTE, 1ST BIT = 1 ) THIS SYSTEM MAINTAINS THIS 3 

VALUE EXACTLY WHEREAS 

MAINTAINED THIS VALUE 

IN 'COPY' . 

FOR FULL SECTOR OPERATIONS, BOTH THE ORIGINAL DOS AND 

THIS SYSTEM ADVANCE 'NEXT' BY 256 ON EACH SUCCESSFUL 

READ OR WRITE TO DISK, EXCEPTING THAT IN 

THIS SYSTEM, 'NEXT' IS NOT ADVANCED ON FULL 

SECTOR WRITE IF THE FCB'S 6TH BYTE NOT = 0, 
-14TH BYTES. THE 14TH, 13TH AND BTH BYTES FORM 

3 BYTE RELATIVE BYTE OFFSET IN THE FILE OF END-OF- 

FILE (THE 1ST BYTE BEYOND THE 

THIS VALUE IS INITIALIZED FROM 

AND IS UPDATED AT SECTOR, 

TIME UNDER CONTROL. OF FCB, 



THE 
■ILE 
THE 
LOGICAL RECORD 
2ND BYTE, 2ND 



IN THE FCB 
MAINTAINED 



FILE OF END 
S LAS1 DATA B' 
FPDE AT OPEN ' 

OR BYTE 

BIT, 

EXACTLY 

IT HIGH 



I ME, 
WRITE 



16. 
17. 



THIS SYSTEM MAINTAINS THE EOF 

WHILE THE ORIGINAL DOS SYSTEM 

WHENEVER FCB 6TH BYTE NOT = 0, 

FOR COMPABILITY, THIS SYSTEM, AT CLOSE TIME WHEN 

THE EOF VALUE IN THE FPDE IS UPDATED, MAKES 1HE EOF 

IN THE FPDE EXACTLY AS FOR THE ORIGINAL DOS SYSTEM. 
15-16TH BYTES. IDENTICAL TO 23-24TH BYTES OF FPDE, 
17-32TH BYTES, FOUR 4 BYTE ELEMENTS OF THE FORM! 

1. 1-2ND BYTES. RELATIVE GRANULE OFFSET WITHIN 
THE FILE TO THE START OF THE DISK AREA 



CURRENT 
BY 256 



WHOSE EXTENT ELEMENT FOLLOWS. 



HE 
F IRS 



2. 3-4TH BYTES. THE EXTENT ELEMENT OF ONE OF ' 
AREAS ASSIGNED TO THE FILE( EXCEPT THE 
SEE FPDE, BYTES 23-30. 
THESE FOUR ELEMENTS ALLOW THE SYSTEM TO REDUCE 
DIRECTORY ACCESS DURING RANDOM FILE OPERATIONS BY 
REMEMBERING THE MOST RECENT 4 AREAS( OTHER THAN THE 
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04300 i FIRST) ACCESSED. UNDER THE ASSUMPTION THAT A SECTOR 

04310 I FROM ONE OF THOSE AREAS WILL BE THE NEXT ACCESSED OR 

04320 i WRITTEN* 

04330 i 14, EOF END-OF-FILE. THE RELATIVE. BY IE ADDRESSI1 WITHIN 

04340 i THE FILE OF THE LAST BYTE OF THE FILE* 

04350 f 

04360 5 END SYSHODS1/COM5 APPEND SYSMODS2/C0H NEXT ! 

04370 I SYSM0DS2/C0M 

04380 J 

04390 5##* 001 %%tti%t%%%ttttttt%ttttttttttttttWMtttt$ttttt 

04400 r 

04410 ?DOS COMMAND 'DIRCHECK' 

04420 ? 

04430 5 THE BIRCHECK/CMB HODULE TESTS AND LISTS THE TARGET DISKETTE'S DIRECTORY* 

04440 i 

04450 } TO THE QUERY 'OUTPUT TO PRINTER'* REPLY Y FOR YES OR N FOR NO (OUTPUT TO DISPLAY), 

04460 ?TO THE QUERY 'WHICH DRIVE CONTAINS TARGET DISKETTE' REPLY A DECIMAL DIGIT 10 4. 

04470 i 

04480 5C0MPLAINTS ABOUT THE DIRECTORY ARE LISTED FIRST, IF A NUMBER IS GIVEN* 

04490 i IT IS IN HEXIDECIMAL FOR USE IN DIRECTORY REPAIR VIA 'SUPER2AP', 

04500 5 DO NOT TRY TO REPAIR A BAD DIRECTORY UNLESS YOU KNOW WHAT YOU ARE DOING! !!!!!! 

04510 ?THE NEXT BEST THING IS TO TRY TO EXTRACT VALUED FILES VIA COPY AND 

04520 JTHEN RE-FORMAT THE DISKETTE HAVING THE BAD DIRECTORY. 

04530 i 

04540 5IF THE COMPLAINT IS ABOUT A DIRECTORY ENTRY FOR A FILE* EITHER THE PRIMARY 

04550 i OR AN EXTENDED ENTRY* THE HEXIDECIMAL CODE IS THE DEC 

04560 vFOR THE FILE'S F'PDE, 

04570 5WHEN THE COMPLAINT DEALS WITH A FILE EXTENDED DIRECTORY ENTRY BUI DOES NOT 

045S0 JSPECIFY THE FILE NAME/TYPEs THE HEXIDECIMAL CODE IS THE DEC 

04590 JFOR THE FXDE ITSELF. 

04600 J WHEN THE COMPLAINT DEALS WITH A HIT SECTOR BY it? THE HEXIDECIMAL CODE IS THE 

04610 5RELATIVE ADDR OF THAT BYTE IN THE HIT SECTOR, 

04620 ?UHEN THE COMPLAINT DEALS WITH A CAT SECTOR BYTE* THE HEXIDECIMAL CODE IS THE 

04630 J RELATIVE ADDR OF THAT BYTE IN THE CAT SECTOR, 

04640 JUHEN THE COMPLAINT DEALS WITH A GRANULE* THE HEXIDECIMAL VALUE IS THE RELATIVE 

04650 ^GRANULE NUMBER WITHIN THE D1SKEHE, 

04660 i WHEN THE COMPLAINT DEALS WITH A TRACK? THE HEXIDECIMAL VALUE IS THE RELATIVE 

04670 J TRACK NUMBER WITHIN THE DISKETTE, 

04680 ?' DIRCHECK' ALSO DEMANDS THAI THE 1ST 2 BYTES OF THE DISKETTE'S 1ST SECTOR 

04690 J< BOOT/SYS' S 1ST SECTOR) CONTAIN 00 HEX AND FE HEX RESPECTIVELY, THE 3RD 

04700 5BYTE MUST CONTAIN THE RELATIVE $ OF THE TRACK CONTAINING THE DIRECTORY. 

04710 5 

04720 i 

04730 i THE FILES ARE NEXT LISTED? WITH NUMERIC VALUES IN DECIMAL, 

04740 I 1. S SYSTEM FILE. 

04750 i 2. I FILE HAS INVISIBLE ATTRIBUiE, 

04760 I 3, P=NNN FILE HAS PROTECTION LEVEL NNN? AND BOTH UPDATE AND 

04770 i ACCESS PASSWORDS ARE NON-BLANK, 

04780 i 4. EOF = SSS/BBB SSS - THE RELATIVE SECTOR WITHIN THE FILE, 

04790 ', BBB - THE RELATIVE BYTE WITHIN THE SECTOR, 

04800 i 5* NNN EXTS THE * OF EXTENT ELEMENTS WITH 1ST BYTE < 254. 

04810 i 6. NNN SECTORS THE NUMBER OF SECTORS ALLOCATED TO THIS FILE. 

04820 5 

04830 ?TO THE QUERY 'START PROGRAM ANEW?'? REPLY Y FOR YES UK N FOR HO (EXITS TO DOS), 

04840 5 

04350 J DURING DISPLAY/LISTING, PRESSINGS 

04860 i 'BREAK' - DISPLAYING/LISTING WILL PAUSE A! END 01 CURRENT LINE 

04370 I OR LINE GROUP, 

04880 i 'ENTER' - RESTARTS PAUSED DISPLAYING/LISTING. 

04890 i 'UP-ARROU' - TERMINATE DISPLAYING/LISTING, 
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04900 5 

04910 ? 

04920 5 

04930 ? 

04940 ? Ut 002 M*%nM:t%t*t%**tt*UMt%MMtmttnt%tM.ttt*t 

04950 J 

04960 JCHANGE TO CAUSE DISK SEEK AND RESTORES TO CONSTANTLY RESELECT THE 

04970 JCURRENT DRIVE WHILE WAITING FOR DISK CONTROLLER TO CONCLUDE THE SEEK/RESTORE. 

04980 JIN THE ORIGINAL SYSTEM* THERE IS INSUFFICIENT DRIVE 'READY' TiKE TO 

04990 ? MOVE THE ARM FROM TRACK OOH TO TRACK 22H AND HAVE A FULL 200MS TO READ 

05000 JTHE FARTHEST SECTOR ON THE TRACK, THIS IS DUE TO --READY-' BEING ON ONLY 

05010 JAPPRQX 2,4 SECS FROM LAST SELECT (WRITE TO 37E1H), THE TIHE EXPIRES AFTER 

05020 J A 1 SECOND WAIT FOR DRIVE DEFAULT-UP TO- SPEED AND THEN 34 40MS STEPS OF 

05030 JTHE DISK ARM, 

05040 J DOS-BASIC 'GET' AND 'PUT' AVOIDED THIS PROBLEM BY DOING AN EXTRA SEEK 

05050 5 VIA CALL AT 62ftBH 

05060 J ANYWAY? THIS CHANGE KEEPS THE DRIVE READY FOR THE ENTIRE SEEK/RESTORE (EVEN 

05070 ?IF THE ARM MUST STEP 70 TRACKS) PLUS APPROX 2,4 SECOND BEYOND THAT, 

05080 JSYSO 4869 AND OTHERS 

05090 JSY33? FORMAT PART 

05100 JFGRMAT 575C? 5764? 556D 

05110 J 

05120 J 

05130 J 

05140 Ittt 003 * * >K * * ^: * ^: ^: * Jf: ^ * * ^ ^: ^: *: ^: * ^: *: *: * *: *: ^: g-: >?: ^: ^: *: >5< ^< * * ^: ^: * ;f : >^: ;t ^c *: i{<: 

05150 5 

05160 5ENABLES DEVICE-NOT-READY CONDITION TO BECOME A VALID ERROR IN SYSO'S READ/WRITE 

05170 J SECTOR ROUTINES? WHEREAS BEFORE IT WAS GOING UNNOTICED AND CAUSING CALLING 

05180 JROUTINES TO ASSUME OPERATION COMPLETED WITHOUT ERROR, 

05190 ? SYSO 46AF 

05200 ?******** incorporated in change #007 

05210 J 
05220 I 
05230 i 

05240 ?m 004 ntnnnuMnwnwMUMMMnxnttnttnwn 

05250 J 

05260 JDIRECT ADDRESSING? VICE INDIRECT? REQUIRED HERE, 

05270 rTHIS ERROR CAUSES REAL TROUBLE FOR PROGRAMS THAT WANT TO USE 'BREAK' AS ■ 

05280 JIT CAUSES THE SYSTEM TO THINK 'DEBUG' IS ACTIVATED WHEN IT HAS NOT BEEN, 

05290 J'EDTASM' MUST RUN WITH INTERRUPTS OFF BECAUSE OF THIS, 

05300 J SY31? 4E28 

05310 J 

05320 ? 

05330 J 

05340 ?*** 005 nruut%%uttutt%t i n:%n^tttnt^utttttnttnt 

05350 5 

05360 JCODE FOR SHIFTING DOWN OLDER USED EXTENT REFERENCES IN 1HE FEB IS JUST PLAIN 

05370 J WRONG, 

05380 JSYSO? 497A 

05390 J 

05400 J 

05410 J 

05420 »*** 006 **t*t*********t*****************#»**********4*** 

05430 J 

05440 JNC STATE ALWAYS SET HERE, USE NZ INSTEAD? WHICH HEANS >= EOF , 

05450 JSYSO? 47F9 

05460 i ******** INCORPORATED IN CHANGE #015 

05470 J 

054SO I 

05490 5 
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05500 

05510 

05520 

05530 

05540 

05550 

05560 

05570 

05580 

05590 

05600 

05610 

05620 

05630 

05640 

05650 

05660 

05670 

05680 

05690 

05700 

05710 

05720 

05730 

05740 

05750 

05760 

05770 

05730 

05790 

05800 

05810 

05820 

05830 

05340 

05850 

05860 

05370 

05880 

05890 

05900 

05910 

05920 

05930 

05940 

05950 

05960 

05970 

05980 

05990 

06000 

06010 

06020 

06030 

06040 

06050 

06060 

06070 

06080 

06090 



?W 007 tM*t%%nWMtZ%ZtttUtn*M%M%*%MM*%****&%* 



CHANGE TO: 



1. 



FORCE VALIDITY READ AFTER EVERY SECTOR WRITE WHEN* 

1, BIT 7, FCB 2ND BYTE ~ I (BYTE OPS) 

2, BASIC IS WRITING TO DATA FILES 

3, ALL SYSTEM WRITES NOT FOLLOWED BY A SUBSEQUEN I READ, 
DISABLE INTERRUPTS DURING SECTOR READ/WRITE OPERATIONS, THIS 
CAUSES THE CLOCK TO LOSE APPROX 120MB EACH I/O, 

IF A HORE ACCURATE CLOCK IS REQUIRED FOR USER OPERATIONS? THIS 
CAN BE REDUCED TO ABOUT A iOHS CLOCK LOSS PER I/O WHILE HAVING 
I/Q'S TAKE 5-10% LONGER BY CHANGING SYSO? 4692, 
SYSO* 4692 HEX IS LOCATED AS RELATIVE BYTE 4A HEX OF RELATIVE 
SECTOR 4 OF FILE SYBO/SYS? AND IF FILE SYSO/SYS'S FPDE 



3. 



23-24TH BYTES - 0022 HEX? THEN THE 
4A HEX IN RELATIVE SECTOR 9 OP RELA 
THE BYTE PRECEDING THE 1ARGET BYTE = 
THE BYTE FOLLOWING - 36 HEX, 

1, SET TARGET BYTE = 00 HEX IF 

SLOWER I/O IS WANTED, 

2, SET TARGET BYTE - P3 HEX IP 

AND THE FASTER I/O WANTED 
SET TO THIS STATE, 
AFTER CHANGING THIS BYTE* DO 'RESET, 
CATCH DEVICE-NOT-READY EVEN THOUGH CONTROLLER 



ARGET BYTE IS RELATIVE BYTE 
IVE TRACK ON THE DISKETTE, 
3/ HEX* AND THE BY I E 



A HORE ACCURATE CLOCK BUI 



CLOCK VALUE NO I 
THIS SYSTEM 



IMP OR] AN I 
IS INITIALLY 



REHA1NS BUI 



THIS WAS AN ERROR s 



SYSO ? 

SYS2 

SYS3 

SYS6 

BASIC 



4, DELAY RE-ENABLING INTERRUPTS UNTIL TERMINATING CONDITIONS HAVE 
BEEN EXTRACTED FROM CONTROLLER, DON'T KNOW 
BUT IT SEEHS SENSIBLE, 
HOPEFULLY? THIS WILL REDUCE DISK ERRORS,,,,,,, 
4860 v 4671 » 468F? 45BF 
514B 
5014 
5445 
62BF 



5*** 008 %%%%%%%ttt%t%%%%%%%%tttt%tt%tt%tttt%%t%%t%%%ttt% 



OPERATE 



IF THEY HAD NO PASSWORD: 



5 DISABLE ALL PASSWORD CHECKS IN 'OPEN', 
I PROTECTION CODE IS DISABLED, PROGRAMS 

?AT ALL, 

I THIS IS NOT AN ERROR CORRECTION BUT A CONVENIENCE, 

I THIS PATCH NEEDED WHEN ACCESS/UPDATE NEEDED TO SYSTEM PROGRAMS BY METHOD OTHER 

fTHAN 'SUPERZAP-', 

; ONLY ONE BYTE IS 

f CHECKING ENABLED » 

*THE BYTE - 18 HEX 

^LOCATED IN FILE SYS2/SYS? RELATIVE SECTOR 

5FILE SYS2/SYS HAS ITS FPDE? 23-24 l H BYTES = 

?AT RELATIVE POSITION 63 HEX WITHIN RELATIVE 

510 HEX OF THE SUBJECT DISKETTE, AS A CHECK , 

»E1 HEX AND THE FOLLOWING BYTE = 21 HEX, 



CHANGED? THAT LOCATED AT SYS2:,4EAC, WITH PASSWORD 
THAT BYTE ~ 28 HEX, WITH PASSWORD CHECKING DISABLE 
THIS BYTE CAN BE ALIERED VIA 'SUPERZAP', THE BY 



IR- 



RELATIVE 
TEX* 



BYTE 63 HEX 
THEN THE BY 



SECTOR 6 WITHIN RELAT 
THE PRECEDING BYTE -• 



, 1 
TE I 
IVE 



Li 

E IS 
F 

f ■ 

TRAGI 



SYS2» 4EAC 



ntt 009 m*:m#mmmmmmmmmmm;mi'm 

? 

5 SYS4t B AND C REGS LOADED TOO LATE FOR DIRECTORY SECTOR READ AT 4EG4H, 
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06100 
06110 
06120 
06130 
06140 
06150 
06160 
06170 
06180 
06190 
06200 
06210 
06220 
06230 
06240 
06250 
06260 
06270 
06280 
06290 
06300 
06310 
06320 
06330 
06340 
06350 
06360 
06370 
06380 
06390 
06400 
06410 
06420 
06430 
06440 
06450 
06460 
06470 
06480 
06490 
06500 
06510 
06520 
06530 
06540 
06550 
06560 
06570 
06580 
06590 
06600 
06610 
06620 
06630 
06640 
06650 
06660 
06670 
06680 
06690 



SYS4* 4E36 



\%n oio *t**#********#*****************t*#****t#*t*« 

; SYSOt PROTECTION CHECK DURING LOAD/EXEC FUNCTION IS THAI FOR 'READ'. NOT ' EXEC 
ALSO ENABLE CALL OF FILE-ACCESS-INHIBITED ERROR FOR LOAD/EXEC REGARDLESS 
OF 'DEBUG' STATUS, 
SYS0» 4C2E 



nt on u**ttt%tm.t**K**k****%tz%ttznzttt%WMtzt* 



I.LCH ALLOWS USE OK 



i HAVE SYSO ALLOCATE IN UNITS OF 1 GRANULE? MICE 2* 

J LAST GRANULE ON DISKETTE, 

I THIS WILL INCREASE WRITE OVERHEADS, 

J SYSO* 4A17 



i%u 012 nttnnttttttutnnMmtuttntttnMMttntn 

i CHANGE TO ALUW 'CLOSE' FUNCTION IN SY33 TO DEALLOCATE THE UNUSED GRANULE WHEN 
i THE LOGICAL END OF FILE IS THE FIRST BY] E OF THE GRANULE, 
J THIS ASSUMES THAT THE EOF BYTE IS NOT A PART OF THE RLE, 
I SYS3* 4E80? 50 IB 



* ii- * \L~ A i ~I ■&' *l- & v( - *i* *k *£• *&• l l' 4- 4* 4- x a *i* -a- 4- ^' •-i- ■■£* *&" ^i' * \!>- 4' 4- ■-!•' k "■=■ '-!-• '■&' >i' >£-• &* -'-' 4* ^ hV' ^ ** '&' -4- •/-■• * '4' *£* l '-' '-' ^ 
¥ ?. if. ^. y X J> 'T* *r- * *?• *v- n- *$■ * '?■ *?• •?• *r- '?- 4- 'r- n- '1- 'i- * *h '»• 'T * * a- 'f- ^ '•■ »■ • 'i • 'f- $• *V- '. • *x> *p 'V- t- i- n • 'r- »r- *v- '?• 't- n • 'r- «i- 



? 'LOAD' IN BASIC SETS 'ENDii OF TEXT' IN 4 0F9 f n ONE 
J MAKE BASIC PROGRAM MODULES 1 BYTE TOO LONG> BUT HAS 
i EFFECT, 
i BASIC » 5FDC 



BYTE TOO HIGH, TENDS TO 
NO NOTICEABLE LRROREOUS 



n%% 014 #*»********«********* 

5DOS SYSOjINIT INITIALIZES 4158- 43FF AND THEN? THROUGHOUT SUBSEQUENT SYSTEM 

50PERATIQN? NEVER USES IT? EXCEPT FOR UNEXPLAINED REFERENCE TO 4359 IN SYSI 

5A REFERENCE TO 43C0-FF BY SYS6 FOR 'DEVICE'? AND AN UNINTENTIONAL REFERENCE 

JTO 43FFH AS A RESULT OF INSTRUCTIONS IN SYSO. 46C1-CE, 

?I HAVE CRITICAL NEED FOR A DOS RESIDENT PATCH AREA, 

J I WILL GAMBLE THAT THIS AREA IS TRULY AVAILABLE AND USE 

5 'DEVICE' COMMAND IS DISABLED IN THIS SYSTEM, 



IT. 



J************* EXTREME CAUTION! !!!!!!!! 
SYS0» 4E20 



'V-'r-i-'i'-'t-'V-'t- 



SYS6? 



c-7 



ID 



m************** SEE SUBSEQUENT PATCHES FOR THIS AREA'S USE 



,tn 015 nt*nt**********:***JSc**************t#********tu 



SDQS MISUSES? AT TIMES? THE CONCEPT OF EOF (FPBE+lSHi 
J AND OF CURRENT POSITION WITHIN THE FILE (FCB+OBFb OA 



14Hs 03HXFCB+0DH 
As O r ciH>, 



OCHi 08H) 
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06700 

06710 

06720 

06730 

06740 

06750 

06760 

06770 

06780 

06790 

06800 

06810 

06820 

06830 

06840 

06850 

06860 

06870 

06880 

06890 

06900 

06910 

06920 

06930 

06940 

06950 

06960 

06970 

06980 

06990 

07000 

07010 

07020 

07030 

07040 

07050 

07060 

07070 

07080 

07090 

07100 

07110 

07120 

07130 

07140 

07150 

07160 

07170 

07180 

07190 

07200 

07210 

07220 

07230 

07240 



? THESE TWO 3 BYTE VALUES REPRESENT RELATIVE. BYTE POSITIONS UITHIN THE FILE OF t 

i 1. THE 1ST BYTE AFTER THE LOGICAL END OF FILE* 

i 2. THE NEXT BYTE TO BE PROCESSED EITHER BY READ OR WRITE, 

STHESE CHANGES ARE TO t 

} 1. ALLOU PROPER OPERATION UNDER THIS CONCEPT, 

i 2. YET. PRESERVE EOF VALUE IN FPDE IN DOS ERRONEOUS STATE SO FILES 

i CAN BE USED IN EITHER THE 'ORIGINAL'' DOS SYSTEM OR MY 'ALTERED' 

i SYSTEM? BUT NOT A MIXTURE OF BOTH. 

5SYS2? 4FE8 

SSYS3? 4E19 

f-SYSO? 4864? 47F6? 47C5? 47CC 

5 

? 



;m 016 MMMW*M%WMX**t*w%u*%%n4*n**nttt*ttt 



S IF THE NEW KEY PRESSED IS 
^REQUIRE THAT IT STILL BE 
? INCLUDES 



FHE 



LAST 
FROM 



KEY 
THE 



ACCEPTED BY THE 
DECODE ROUTINE! 



SYSTEM? 
UHICH 



AME AS THE 
UPON EXIT 
A DELAY OF APPROXIMATELY 50 MS. 
5THIS IS AN ATTEMPT TO REDUCE THE NUHEO OF UNINTENTIONAL REPEATED KEYSTROKES. 
?THIS CHANGE INSERTS 'ZAP07' ADDR (IN DOS RESIDENT ROUTINE SYSO ) INTO 
?4016?7 (ROUTINE ADDR IN KEYBOARD CONTROL BLOCK) AND CALLS 03FAHr VICE 03E3H? 
? TO GET THE CURRENT KEY. THIS MIGHT MEAN TROUBLE FOR ANY OF THE FOLLOWING,; 
? 1. OTHER USERS WHO CHANGE THIS ADDRESS VALUE IN THE CONTROL BLOCK. 
? 2. ROUTINES WHICH LOAD DIRECTLY OR INDIRECTLY INTO THE DOS AREA? 
i 4000-51FF, 

***** note: this 'debqunce rou 
54016-7 unchanged) if shift-up 



THEN 



FINE' WILL NOT 
ARROW IS PRESS 



ED 



fIVATE (LEAVING THE 
FROM RESET OR POUEF 



ADDR 
-ON 



A'l 



? UNTIL THE 1ST MSG APPEARS 
? WITH THE DEBOUNCE ROUTINE 
? SOMEWHAT. (SEE CHANGE *0i; 
I SYSO? 4E20 



ON THE DISPLAY 
DEALT lUnTELf? 



JKL' OPERATION IS ALTERED 



i ttt 17 MMttZtZKtttttttttMXWXtW 



? 

SIN 
?TO BE 
? J? K 



CONJUNCTION WITH CHANGE #016? THIS CHANGE ALLOWS 



SENT AS SIXTEEN 



CHAR LINES TO THE LINE PRIN 



THE FULL DISPLAY CONTENTS 
ER WHENEVER THE 3 KEYS 



AND 

1. 



L ARE SIMULTANEOUSLY DEPRESSED AND ONE OF 



'DEBOUNCE' IS ACTIVATED 
IS TESTING FOR A 
SEEN BY THE CALLING 



(SEE CHANGE 
KEY ■ 
PROGRAM). 



#017 )? 
(Jc K 



10 A 



•" DEBOUNC 

BE INPUTTED 

THIS TIHE,- 

E TO THE PRINTER IS 

PERIODS. THIS WILL 



t 2. CLOCK INTERRUPTS ARE ENABLED. IF 

? ONE OR MORE OF J? K OR L HAY 

I WAITING ON KEYBOARD INPUT AT 

?THE ONLY EDITING DONE BY THIS ROUTINE ENROU1 
?ALL CHARS WHOSE HEXIDECIMAL VALUE >=- 80H 10 
? GRAPHICS TO PRINT AS PERIODS. 
? 
ISYSO* 452JJ? 4E20 



ittt 018 **#***********#****************:S:!i-**!f:*:{:*^*!l4:'*4: 



THE F 
AND 
OR 

IS 



OLLOWING EXISTS 
A USER PROGRAM 
L IS NOT 



ACTIVATED* 
PROG RAH 



TO CHANGE 
CAUSE 



07250 , 

07260 5L.2 BASIC DOES NOT FULLY CONVERT BOTH SHIFT AND NON-SHIFT VALUES FOR THE LETTERS 

07270 JA-Z AND THE SYHBOL B TO ASCII UPPER CASE. (BASIC'S KEY INPUT ROUTINE ACTUALLY 

07280 ? CONVERTS THESE CHARS INITIALLY FROM LOWER TO UPPER AND UPPER TO LOWER. THEN 

07290 ? THE SOURCE PACK ROUTINE (1BC0) CONVERTS HOST BUT NOT ALL OF THE NOy LOyER 
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07300 i (ORIGINALLY UPPER) CASE CHARS BACK TO UPPER CASE.) 

07310 ^PROPER BASIC PROGRAM OPERATION REQUIRES ALL CHARACTERS IN THE TEXT TO BE UPPER 

07320 5 CASE FOR AND tr Z ♦ ERRORS IN THIS REGARD ARE NOW CORRECTED WHEN LINE IS 

07330 J ENTERED (OR EDITED). LOWER-CASE TEXT IS RETAINED BY NEWDOS IF SUCH LINES ARE 

07340 CENTERED AND EDITED BY TRSBOS ONLY. 

07350 i 

07360 ITHIS 'FILTER' MAY BE INHIBITED USING SUPERZAP? ON NEWDOS! DISKETTE TR.3? SEC ,5s 

07370 SHOD 6D & 6E FROM 00 52 TO 33 60* 

07380 } 

07390 ? BASIC ? 5523 

07400 I 

07410 » 

07420 mt 019 «ttm«««»u , «t««««.«m.«tt«ii;**tt 

07430 i 

07440 i PROVIDE DOS- BASIC WITH AN OPEN "E" FUNCTION WHICH t 

07450 J 1» OPENS A FILE 

07460 t 2. SETS 'NEXT' INDICATOR" 'EOF', < FCBT5? A?B :■ FCDT3?C?D) 

07470 i 3, SETS PROCESSING TO CONTINUE AS IF OPEN "Q". 

07480 ?THIS ALLOWS THE USER TO ADD TO A SEQUENTIAL FILE* 

07490 SIF THE FILE WAS CREATED BY OPEN OR WAS NOT YET PREVIOUSLY WRITlEH TO 

07500 I (IE» EOF : 0)? THEN OPEN "E" OPERATES EXACTLY AS OPEN "0% 

07510 ? BASIC? 6372? 63B6 

07520 i 

07530 ? 

07540 an 020 nMnn%*nMnMn*Mn.uMMU*MMMt*uu 

07550 i S 

07560 ?'E0F' FUNCTION WILL MALFUNCTION UNDER THE REMOTE POSSIBILITY OF 'NEXT' > 'EOF' 

07570 ?ANB THE EOF BYTE AT MISMATCH =• 

07580 i BASIC:.- 61BF? 6200 

07590 I 

07600 » 

07610 fttt 021 m*«mmmmummm£m£a:*;mmm* 

07620 i ■ 

07630 f'LOC COMHAND IN DOS- BASIC FAILS DUE "10 ERRONEOUS CALL, 

07640 ? BASIC 6231 

07650 » 

07660 f 

07670 tttt 022 nnttntnuiuuuntutnututnuMttnt 

07680 J 

07690 5 DOS- BASIC'S FILESPEC EDIT ROUTINE ALLOWS ONLY A 22 CHAR FILESPEC WHEREAS 

07700 JSYSTEM DEFINITION ALLOWS FOR 23 ( NNNNNNNN/TTT ♦PPPPPfWtD ) 

07710 » BASIC? 630C 

07720 i 

07730 » 

07740 ?*** 023 mmmmwmmmm4:mm:mmm#«m 

07750 i 

07760 ?' APPEND' DOS COMMAND JUST DOESN'T WORK, HOPEFULLY NOW IT DOES, 

07770 ? SY36? 573D 

07780 J 

07790 » 

07800 J*** 024 Jlc**********************^*****^************^** 

07810 ? 

07820 JUHEN DOING LOGICAL TRANSFER (BYTE OR LOGICAL RECORD )( BIT ??S CBIi ON)? THE 

07830 J OUTPUT SECTOR BUFFER MUST BE DIFFERENT FROM THE INPUT SECTOR DUFFER, 

07840 ? SYS6? 5720 

07850 ? 

07860 ? 

07870 »**# 025 ******************************************** 

07380 ? 

07890 5 'VERIFY' CHANGES THE WRONG INSTRUCTION IN SYSO? CHANCING THE WRIT E-Wi i H-VLRIh Y 



lb - 



07900 SECTOR RATHER MAN ML WRITE WITPiOU I -VLR1FY VbC'lUK* 

07910 5 SYS6? 550F 

07920 I 

07930 ? 

07940 ? 

07950 ?$£& 026 ttlUitnit^lU-iti'iiUiUUHUM^UUliit^ 

07960 f 

07970 r'ATTRIB' USES THE. WRONG ERROR LODE 

079B0 ? SYS6r 5B21 



vtKHv ;•• 



03040 f'ATMiB' BA 

0305O » SYS6 

08060 ? 

08070 i 

03080 ? 



08 i.-- : MRu'TOE Ai'Mifr" yiiH lAPABILH V' Uf i Ukr-iINu- Or r I riL i-N-ziuitLt fn 
08120 f SY36r UC02 
0813O f 



ijuij- 






08160 


im i 


• i! ")' *v 'i '7 o 


03170 


i 




08180 


- r vr - 
v C. 1 I -J i. 


3 Lm! ;i : ; u 1 c 


08 190 


;: T L.i A r. 
:- > t ir.i 


■i .JUbT !•" 


08200 


? SYbJ 


• ', ■'■. \ i ,i '; 


08210 


5 




08220 


? 




A r i "i i'\ 

V u i- ■_« V 


y 


L f2'!T. 


08240 


f 




A •■"/''".;•, 
V u C O V 




03;j *4>, . 



T -Y ' 



iu L,-fiUuL KiLL sU .L.t_KU a L> s fci m i. ,; ' nt. Li_i.crr.i.' ? i Ui_ u ? . i" ADi-? nh i i ii_rt 



jhi ! .i.f's'u i rib c.P 



08260 f 

08270 ''CLOSE' IN bibb Lr'BjStrj f; MfVj'JK b i ;. i tin lu ji ri i i_rr wrier, l > i,E..i_x.riaL. j t, > al'l. t- i kui 

08280 ^'RESERVING ME CONTENIb Or REG HI? LOHMINiNu LUuNI i 1 Ur SGCiOHb 'fbi iu i>E FREED? 

08290 MHEN FREEING A NO LONGER NEEDED FXDL- 

08300 ?THIS ERROR IS COHPOUNBED BY THE BRANLR Ai iEDV Nu i MPLiLiiLi ENDING iJEAELOCA i ION 

0831O ?WHEN THE FILE IS KNOWN 10 HAVE NO MORE. GRANULES MbSIGNtD* 

08320 v 

083-50 ?THESE ERRORS LAliaE ALL WRITEABLt HAIN Hr_hUKi 1 i\Un 3000 4 2.'; A IU GE oLi - :: ir t 

08340 y WHERE XX IS RELATIVE POSITION WilHIN IHE bEGTuR 01 IHE Lnb i BYTE OF ME i PiJE 

08350 ? POINTED TO BY THE LAST FXDE RELEASED, 

08360 ?THE CORRESPONDING SECTOR IN THE BIRECIORY ib nLbO (• 1LLLU Willi 'FP 10 MAl 

08370 .RELATIVE POINT, 

08380 DFIJRTHER? AS THIS COES ON* IHE CAT DIEECTORV SEG i UK ib HODir IED TO FREE UP 

08390 ^GRANULES AT RANDOM IN TRACKS 00-FF? WITH HOST fRALKb DElUW S0H. 

08400 f UNDETECTED* THIS WILL CAUSE. GRANULES PREyiOUbLY ALLOGAiEB 10 CJ'JHEK FILES 10 

08410 ?BE ALLOGAIEB AGAIN IN SUBSEQUENT FILE ALLOCA1 IGNr; » 

08420 JTHIS INCLUDES REALLOCATION OF BOOT/SYS AND DiR/SYb bRANULLb? LyLNMALLi CLuBDERiMG 

08430 J THEM* 

03440 »ALS0r FILES WHOSE F PBE PRECEBED THE DLSIROYRD FPDE iM SHE BIREClORi ENTRY SEClOR 

03450 ?WILL DISAPPEAR FROM THE SYSTEM ANB IF A l : ILL b I XBL WAS bu DEblRuYLD* SHE USER 

08460 ?SHOULD HAVE HORRENDOUS TROUBLE FROM THAI MLEr CuNSIDEREB LUCK] il I Hb bibiEH 

08470 JDETECTS AN ERROR 

08480 J 

08490 ntttt ALMOST AS BADr HL IS NOT DECREMENTED 10 2MB BYlE Ui NEXi LOWER 
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08500 ^EXTENT NOR IS IT PROTECTED BY THE DIRECTORY SECTOR WRITE CALL AT 4F08. 

03510 STHIS CAUSES THE TWO BYTES* WHATEVER THEY ARE) AT 4 IFF -4200 TO BE USED AS THE 

08520 JNEXT LOWER EXTENT FOR THE FILE? CAUSING*^ SOMEWHAT RANDOM DEALLOCATION OF 

08530 i GRANULES? USUALLY IN THE RANGE OF TRACK'S 00- 10H, 

08540 I . . ■ • 

0855O ?YET MORE. IF A NEW FXDE IS ALLOCATED TO THE FILE AND THEN THE DiSKEiTE 

08560 HS FOUND TO BE FULL* SYS3 MALf UNCTIONS (AT SOME. FUTURE TIME) WHEN CLOSE TRIES 

08570 5TO FREE THE SPACE ASSIGNED TO THAI FXDE* ASSUMING THERE IS SOME WHEN "I HERE IS 

08580 5 NONE, 

08590 j 

OS600 I SYS3* 4ED9* 4FFD» 500 C* 4F0 8* 4E92* 4ED1 

08610 I 

08620 I 

08630 ? 

08640 itU 031 **U****«********««***************************** 

08650 J 

08660 *CHANGE TO DOS-BASIC TO ALLOW THE FOLLOWING 'DIRECl' COMMANDS J 

08670 i 1. ',' (PERIOD), LIS] CURRENT TEXT LINE, 

08680 -J 2, 'DOWN-ARROW', LIS] NEXT TEXT LINE, IF NO HEX I TEX! LINE? PERFORMS 

0S69O i AS 'SHIFT- DOWN-ARROW' 

08700 S 3. 'UP-ARROW', LIST TEXT LINE BEFORE CURRENT LINE, IF NONE* PERFORMS 

08710 I AS 'SHIFT-UP- ARROW-' , 

08720 i 4, 'SHIFT-UP ARROW'* LIST 1ST TEXT LINE, 

08730 S 5, 'SHIFT-DOWN ARROW', LIST LAST LINE IN TEXT* 

08740 i 6. '*' (COMMA), 'EDIT' CURRENT TEXT LINE, 

08750 i 

08760 cONLY 1 SUCH COMMAND PER DIRECT STATEMENT LINE? AND THE COMMAND* TO BE SEEN* 

08770 J MUST BE THE FIRST CHAR OF THE INPUT LINE (NO SEQUENCE NUMBER ALLOWED AND 

08780 ^BACKSPACING NOT ALLOWED), 

08790 J BASIC? 5993 

08800 i 

08810 J 

08820 f 

08830 ?*** 032 ***mm*««*************^ 

08840 ? 

08850 f IN 'FORMAT'. ALLOW THE USER THE OPTION OF CONTINUING THE FORMAT WHEN DISKEi I E 

08860 i FOUND TO CONTAIN DATA, 

08870 I FORMAT , 54 2C 

08880 » 

08890 ? 

08900 ? 

08910 t-ttt 033 *4:**********************^ 

08920 » 

03930 iNEED 10 POWER UP DRIVE AGAIN IF ADDITIONAL INPUT WAITS PATCHED IN. 

08940 5 FORMAT; 54 64 

08950 J 

08960 } 

08970 i 

08980 ItU 034 ********************************************* 

08990 i 

09000 ?' FORMAT' DOES NOT DAMAGE DOS AREAS, THEREFORE* A SYSTEM RESEl IS NOT 

09010 ^NECESSARY, UPON FINAL 'ENTER'* EXIT VIA 402OH IF FORMAT COMPLETED AND MIA 

09020 ?4030H IF FORMAT DID NOT FULLY COMPLETE, 

09030 i FORMAT* 56 AA 

09040 5 

09050 5 

09060 ? 

09070 ?«* 035 nnnn*%MMMMM*UMMW%$.MtM*M*ttU 

09080 i 

09090 * CHANGES TO ALLOW 'DOS' COMMANDS TO BE EXECUTED WITHIN BASIC'S 'CMD' COMMAND ♦ 
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09100 ?THE 'CMC FUNCTION IS USED? PREEMPTING THE SITUATION WHERE THE QUOTE 

09110 JSTRING CONTAINS MORE THAN ONE CHAR, IF THE LAST CHAR OF THE QUOTE STRING 

09120 ,*IS A '$'j THEN THE STRING IS CONSIDERED T D BE A CHAHAL1ER STRING VARIABLE 

09130 JNAHE? AND THE CONTENTS 01- THAI VARIABLE'S STRING IS USED AS THE QUOTE STRING 

09140 iFOR THE 'CI1D' FUNCTION AS THE DOS COMMAND, 

09150 ? THIS PATCH USES 444B-4466, AN AREA ASSUMED AVAILABLE IN SYSO , 

09160 I 

09170 ? CMD"XX" WILL CAUSE 'On' (OUT OF MEMORY) LRKUR Tu OLLUR I! I HERE IS 

09180 ? INSUFFICIENT FREE SPACE BETWEEN BOTTOM OF STRING AREA AND TOP Of ARRAY AREA. 

09190 J CURRENTLY* ABOUT 8K OF FREE SPACE IS REQUIRED. BEFORE GiJING TO DOS? 

09200 If-, CHECKSUM IS COMPUTED OVER THE ENTIRE MAIN MEMORY AREA OF BASIL THAT 

09210 JTS NOT ALLOWED CHANGED BY THE DOS FUNCTION, THIS TAKES ADGUi 2 SECONuS, 

09220 5 IF THE DOS FUNCTION RETURNS TO BASIC? THIS CHECKSUM IS CUHPUlED AGAIN 

09230 H ANOTHER 2 SECSK IT THE CHECKSUM IS BAD* BASIC CANNU I CONilNUE AND AN 

09240 JEXIT TO ' DOS READY' IS TAKEN, 

09250 I 

09260 ? THE PROGRAM OR FUNCTION INVOKED BY CHD"XX" HAY RETURN TO BAi.iL> iU CUNliNUE 

09270 ? THE BASIC PROGRAM'S EXECUTION, IF IT DID NOT USE ANY Of HLHURY BtiWELN 6! 00 

092SO SAND BASIC'S HIGH ADDR (HEM SIZE) AND IT TAKES ONE OF THE FOLLOWING EXiiS; 

09290 5 1, 402D SUCCESSFUL COMPLETION EXITS, NEXT BASIC STATLHLNi WILL BE 

09300 ? EXECUTED, 

09310 I 2, 4030 UNSUCCESSFUL COMPLETION EXIT , COMPLAIN i HAS ALREADY 

09320 i BEEN D1SPLAYLD,. IF LWD" NOT ACTIVE? UNPKIHLABLt LRRuR' 

09330 I (DECIMAL 3B ) BASIC ERROR WILL BE INVOKED , 

09340 ? CAUSING EITHER THE 'ON LRROR' ROUUNE TO BE INVOKED OR 

09350 i PROGRAM EXECUTION TERMINATED IN ERROR, 

09360 s IF CHD"D" IS ACTIVATE!!? 4030 EXIT GOES TO DEBUG DISPLAY* 

09370 I FROM WHICH 'RESET' MUST BE ISSUED WHEN DONE WI i K DEBUG, 

09380 I 3, 4409 UNSUCCESSFUL COMPLETION EXI i , DEPENDING UPON LIE SYSTEM 

09390 ? ERROR CODE? A BASIC ERROR CODE WILL BE LNVOKEB? CAUSING 1 

09400 ? OF THE TWO <CHD"D n INACTIVE) ORllUNS IN lilt 40i0 EXIT, 

09410 J CMIf'E" CAN DISPLAY THE ACTUAL SYS I EM ERROR Mob, 

09420 ?■ 

09430 nUU CAUTION, IF THE INVOKED DOS FUNCTION (It* A SINGLE DRIVE TWO 

09440 vDISKETTE COPY OR OTHER OBJECT CODE PROGRAMS SUCH AS 'EDTASri' ) 

09450 fUSES BASIC'S MEMORY ABOVE 6F00? EXITING THROUGH ONE 01 THE 

09460 JABVOE THREE ADDRESSES WILL CAUSE UNPREDICTABLE RESULTS AS BASIC'S CODE IS 

09470 i CLOBBERED. WITH LUCK? RESET WILL TAKE PLACE, 

09480 I 

09490 J BASIC » 56CD 

09500 5SYS0 444B-4466 

09510 5 

09520 f 

09530 ? 

09540 ?*** 036 nnnnnMnnnnMMun*Mn:n%tntMMtnt 

09550 5 

09560 5CHANGES TO SPEED UP 'BASIC'S 'LOAD' ANU 'SAVE' OPERATIONS BY USING SECTOR 

09570 ? I/O TO DOS SYSTEM RATHER THAN BYTE 1/0, 

09580 I FOR LARGE BASIC PROGRAMS, LOAD AND SAVE RUN AT APPROX 33% AND 50 X OF 

09590 JPREVIOUS TIMES RESPECTIVELY, 

09600 f 

3055 



09610 


? BASIC? 


5P B6? 


09620 


? 




09630 


9 




09640 


S 




09650 


?#£* 06/ 


• ■,'.■■•-) -.v -.!■-. 

>l- r "i->~\ ■■*!«' 



y rpff.iy. v --J f 'ft ' 'I M" 'I" t-'t'l- 'rl' '(- 'i- 1- r \- 'r '•' ',-';':■ *i '1 'f 't ' 

09660 ? 

09670 } CHANGES TO 'FORMAT' TO ALLOW IT TO EXECUTE WITH PARAMETERS SPECIFIED ALONG 

09680 5WITH THE FORMAT COMMMAND, 

09690 i 



- II 



J I* FORMAT DjNNNNNNNNiKH/DB/YYtPPPPPPPP 

i 2, FORMAT D jNNNNNNNN f MH/BD/YY?PPPPPPPP? Y 

5 WHERE 

i D - RELATIVE NUMBER OF DRIVE TO BE FORMATTED 

i NNNNNNNN - 1-8 CHAR NAME FOR DISKETTE 

I MM/DD/YY - CREATION DATE 

J pppppppp : . i-o CHf - )R PASSWORD 

I Y FARAM IS USED IF OK THAT D1SKEY "I'E BEING FORMATTED CONTAINS DAlAt 

JIF 'D' IS DRIVE (THE SYSTEH DRIVE)? FORMAT WILL ASK FOR 1 HE. 

i PROPER FORMAT/DESTINATION OR SOURCE DISK!. HE 10 DC MOUNTED? AND UPON EXIT WILL 

5ASK FOR A SYSTEH DISKETTE TO BE MOUNTED BACK ON i DRIVE 0, 

i' FORMAT-' IS ALSO MODIFIED SUCH THAI IF LufSriAMD PAPAKS ARK SUPPLIED WITH THE 
j COMMAND? THE COMMAND CAN BE RETRIED AFTER USER HAS CORRECTED THE PROBLEM? 



09700 

09710 

09720 

09730 

09740 

09750 

09760 

09770 

09780 

09790 

09300 

09810 

09S20 

09830 

09340 

09850 

09860 

09370 

09880 

09390 

099O0 

09910 

09920 

09930 i 

09940 ?FORMAT IS ALTERED TO USE UBOO AS BASE OF FULL TRACK L;UF F LK: VICE UFOv, 

?THIS DECREASES FORMAT EXECUTION AREA SIZE 10 REDUCE SIZE SA^LD BY BASIC WHEN 

? EXECUTING DOS COMMANDS, 

IFORMAT 5499? 5526? 5551 



I PROVIDED THE COMMAND PARAHS THEMSELVES ARE MUi 



-RKuE, 



i FORMAT? 522E? 5278 > 



52A0? 52AE? 52B6? 



bilL'L :• -Ji'-L/i" > Ju-'l i 



ItU 038 mmm:Ummwmmmm£m*t;;-ktfm*U:S 



09950 

09960 

09970 

09980 

09990 

10000 

10010 

10020 

10030 

10040 

10050 

10060 

10070 

10080 

10090 

10100 

10110 

10120 

10130 

10140 

10150 

10160 

10170 

10180 

10190 

10200 

10210 

10220 

10230 

10240 

10250 

10260 

10270 

10280 

10290 
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?' BASIC 
5 

J 
? 

? 



IS MODIFIED SUCH THAT V 

1 . BASIC 

2. BASIC * 

3. BASIC N 

4. BASIC M 

5. BASIC CHD 

6. BASIC NsMsCMD 

7. BASIC M?N?CMB 
BASIC NiH 



ACTIVATION SEQUENCE IS ONE OF THE FOLLOWING,; 



8. 
9, 



BASIC M?M 



?■ where: 



10, BASIC NjCHD 

11, BASIC Hi CHD 



* MEANS THE USER WANTS BASIC TO REINS lITUiE I lit PROGRAM IN THE TEXT 
BUFFER? USING THE SAME VALUES FOR H AND N AS APPEAR TO EXIST IN 
MAIN MEMORY, THIS ALLOWS THE USER TO RECOVER FROM AN UNyANTED 



'RESET' OR TO GET BACK TO THE SAME PROGRAM AFTER 
IF BASIC IS ABLE TO ACCOMPLISH THIS? IT FORCES 'LIS 
1ST COMMAND, 



/-. r Mi i !'■ ■::.;» 



Mil" 

l ii.' 



i';b 1 



= t OF 1/0 AREAS, DEFAULT = 
M - MEMORY SIZE, DEFAULT IS ALL 



HA) 



IS, 



-.UiiFUTER HAS, 



f CMD - ANY BASIC DIRECT COMMAND* THIS COMMAND WILL BE EXECUlED AS 

i SOON AS INITIALIZATION IS COMPLETED, 

?ANY ERROR ENCOUNTERED DURING INITIALIZATION CAUSES A RETURN TO DOS, 
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10300 JTHE OLD BASIC STARTUP PROCEDURE IS HEREBY SUPERSEDED. 
10310 I 

1200 » 5BB0? 5BF0r 5C35? 5C54s 5CA4 ;• 5UU; SCO 



10320 


JBftSICf 


10330 


* 


10340 


c 


10350 


*m 040 


10360 


tr 


10370 


r 'COPY' 


10380 


(T 


10390 


c 


10400 


f " 


10410 


? 


10420 


? 


10430 


5 WHERE 


10440 


? 


10450 


i 


10460 


F 


10470 


£ 


10480 


t 


104 90 


tf 


10500 


* 


10510 


f 


10520 


* 


10530 


c 


10540 


c 


10550 


K 


10560 


K 


10570 


C 


10580 


* 


10590 


f 


10600 


* 


10610 


c 


10620 


y 


10630 


5 


10640 


y 


10650 


K 


10660 


5 


10670 


y WHEN 1 



* * * * 4- 1 *• * * ^ *■ * * *■ 

/r- *r» i« i 1 . rf- '?■ i" <?• '*• *?- *»- <r- n* '■ ■ 



■.).■ a ^--J. -.!.■ --i --i'-i-. 



1 O * 



IS ALTERED TO HANDLE THE 
1, COPY FILESPEC1 TO FILESPEC2 (SAME AS OLD COPY) 
COPY $FILESPEC1 TO FILESPEC2 



i. * 



3, COPY {D FILESPEC1 



c< 



COPY Hi tPILESPECI TO T ILESPEC2 



5. COPY JD 10 



!/¥\ 



1, D AND E ARE DRIVE t'S AND HAV BE : . 

2, FILESPEC1 IS THE ' SOURCE' FILE'S FILESPEC. 

3, FILESPEC2 IS THE 'DESTINATION' ! ILL'S FILEOPLC, 

4, $ MEANS THAT EITHER THE SOURCE OR "(HE DESTINATION I ILL Ok BOTH 
ARE ON A DISKETTE CONTAINING AN ALIEN SYSTEM (IE; NOT SHIS SYSTEM; 
IF D IS SPECIFIED AND IS NOT •- (>; THEN $ SHOULD NOT BE SPEC ED 
AS THE NECESSARY COMPATIBLE SVbi'EH ROUTINES;. SYb2 AND SYS3> WILL 
DE TAKEN FROM DRIVE Of WHICH IS ASSUMED TO CONSAIN 'THIS' SYSTEM* 

5, FORMATS 3 AND 4 INDICATE THAT SOURCE AND DESTINATION FILES ARE 
ARSON DIFFERENT DISKETTES; DU I THAT ONLY THE bi'LCii ILD DRIVE WILL 
BE USED TO CONTAIN I HOSE DISKETTES, 

6, FORMAT 5 PERFORMS A BACKUP FUNCTION, BEFORE DA i A IS 
WRITTEN OH THE DESTINATION DISKETTE, li IS iORHiYTILD 10 ALL DAI A 
SECTORS (NO BOOT OR DIRECTORY >, THE ENTIRE GON ! EN ! S OF THE SOURCE 
DISKETTE ARE THEN COPIED ONTO THE DES i INAT ION DISKLilE aNCLUBlNG 
BOOT AND DIRECTORY )f AND THE ' MH/HH/fl" VALUE INSERTED AS THE 
CREATION DATE FOR THE DESTINATION DISKLilE. 

7, WHEN TWO DISKETTES* BUT ONLY 1 DRIVE s ARE SPECIFIED FUR A COPY? 
ALL OF MEMORY ABOVE COPY'S CODE IS USED AS DUFFERS, ALL OTHER 
CASES USE A ONE TRACK BUFFER; THUS ALLOWING; RETURN 10 BASIC; If 
COPY WAS INVOKED VIA BASIC'S CMB"XX" STATEHLNi. 

3, WHENEVER A SPACE IS USED AS A SEPARATOR; ONE AND ONLY ONE IS ALLOWED. 

THE LEADING PORTIONS OF FILESF'EC2 ARE THE SAME AS THAT Oi i IlLSPECIs 

10680 JIT MAY BE LEFT OFF FILESPEC2 WITH FILESPEC2 STARTING WITH ONE OF 7 OR * OR t iO 

10690 J INDICATE THE DIFFERING PORTION. 

1070O p EXAMPLE J 

10710 i COPY ADCB/TTTIO TO ABCD/TlTIl 

10720 JHAY BE WRITTEN AS 

10730 ? COPY ABCD/TTTtO TO il 

10740 5 

10750 i 'COPY' IS NO LONGER EXECUTED AS A FUNCTION WITHIN SYS6, SYSi IS nODIFIED 

10760 HO ROUTE 'COPY' TO CQPY7CHD MODULE, SYS6 IS MODIFIED TO NOT USE ITS 'COPY' 

10770 f FUNCTION. DUE TO ATTEMPTS TO RESTRICT COPY7CMD TO I GRANULE* THL FORMAT 

10780 5PQR7ION OF COPY HAS BEEN PLACED IN SYS3* INVOKED BY THE 

10790 >-70 CODE. 

10800 i 

10310 JALSO» OLD 'COPY' MALFUNCTIONED IF LAST SECTOR BEFORE EOF SEC ! OR IS NOT FULL 

10820 f (IE? FPDE+3 AND FCB+8 <> 0) BECAUSE IT SECTOR READ/WRITES RATHER THAN 

10330 iSINGLE BYTE REfcB/ WRITES. THIS CHANGE CORRECTS THIS. 

10840 i 

10850 5CQPY/CMD 

10860 J SYSi 4EDD 

10870 JSYS6 5216 

10880 JSYS3 ZftPISf FORMAT 
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10900 

10910 

10920 

10930 

10940 

10950 

10960 

10970 

10980 

10990 

11000 

11010 

11020 

11030 

11040 

11050 

11060 

11070 

11030 

11090 

11100 

111.10 

1112.0 

11130 

11140 

11150 

11160 

11170 

11130 

11190 

11200 

11210 

11220 

11230 

11240 

11250 

11260 

11270 

11280 

11290 

11300 

11310 

11320 

11330 

11340 

11350 

11360 

11370 

11380 

11390 

11400 

11410 

11420 

11430 

11440 

11450 

11460 

11470 

11480 

11490 
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{PROGRAM LOADER IN SYSO IS ALTERED TO USE 4200- 42FF; VICE -iDOO- 4UI f- AS IT'S 

t L/0 BUFFER » THUS ALLOWING SYSTEM PROGRAMS TO LOAD INTO 4BO0-4DFF ■, IF DESIRABLE.. 

?A CHECK IS HADE IN THE ACTUAL. I/O CODE TO DISABLE REMEMBRANCE OF THAI 

JSYSTEH PROGRAM BEING IN MAIN MEMORY IF ITS ENTRY POINT WAS WITHIN 4D0O-4DIF 

» AND A READ/WRITE SECTOR TAKES PLACE ON THAT AREA, 

fSYSO 4C18f 
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r IF A SYSTEM MODULE BEING LOADED USING THE 16 BY1E. FEB (HALF SIZE) Al '!4A0j 
5 AN ' RECORD OUT OF RANGE' (1DH) ERROR IS 'GALLED IF I ILL HAS MORE THAN 
»ONE EXTENT. 
?SYS0 4912 



* * * 4- A A 7 \'.-' * * ■■'■• -.V ' 



r***/, -.*. ■•;, ■£-- v.- 



5IF THE SYSTEM MODULE 'CALL' ROUTINE FINDS IHE MODULE'' S DIRECTORY ENTRY 
^INACTIVE; THEN ONE OF THE FOLLOWING: 

i 1, IF SYS4 IS AN ACTIVE MOBU! L IN THE SYSTEM; THEN 'FILE NU1 IN DIRECTORY 

i ERROR WILL BE DISPLAYED MIA JUMP TO SYS 

i BASIC WILL INTERCEPT). 

? 2, IF THE JUMP TO SYS4 VIA 4409 M.NDS SYS' 

i 'RESET' WILL BE INVOKED. 

I SYSO 4BD4 



AT -4409H ( IF CnD"XX l! > 
NOT IN THE SYSTEM; THEN 



?T0 REDUCE THE RESIDENT SIZE OF BASIC (DUE 10 ADDED CODE) THE FOLLOWING 

5 STEPS HAVE BEEN TAKEN { 

5 1, SYS13/SYS MODULE CREATED TO CONTAIN DOS BASIC'S 

i ERROR DISPLAY CODE AND TABLE. 

2. 5200-5555; ENTRY TO 5200 IS CHANGED TO ZAP 18. ERROR MESSAGES 



AND ERROR DISPLAY CODE PROM 57D2 57E0 ARE MOVED TO SYS1S. 

THE JUMP VECTORS (54C3-5551j) ARE MOVED TO 4D00 AS ) HEY ARE NEEDED 

ONLY DURING INITIALIZATION. 

3. 57B2-5823; THE ERROR DISPLAY CODE (57B2-57E0) IS MOVED TO SYSI3. 
CODE (57E1-573F) IS DELETED AND CM1TX" DISABLED. 

THE AUTHORED/COPYRIGHTED MSG IS APPENDED; DISPLAYED DURING 
INITIALIZATION AND THEN ITS STORAGE REUSED. 

4. 5BA4-5DC7: INITIALIZITION CODE GREATLY MODIFIED, COMMAND BUFFER 
SHIFTED TO 5BAB-5C9D TO OVERLAP INITIALIZATION CODE? WHICH IS 

NOT NEEDED AFTER INITIALIZATION. THE ROUTINE AT 5C8D-5CV0 
NOU AT 5BA4-5BA9. 

5. 5A15-5B13J ROUTINE AT 5A5B- 5A66 MOVED TO 5A15- 5120 . HAVE NO IDE 
WHAT THE REST OF THE AREA WAS USED FOR? SO WILL USE 11 FOR 
APPENDAGE CODE. 

6. IF NECESSARY! MORE APPENDAGE CODE CAN BE ADDED AT 64 31, 
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11510 I 

11520 I THROUGH NEW SYSTEM MODULE 'SYS12/SYS' THE FOLLOWING BASIC COMMAND IS ALLOULLU 

11530 f 

11540 } 1, REF* DISPLAY FULL REFERENCE LIST ^ 

11550 ? 2, REF* PRINT FULL REFERENCE LIS! ON LINE FRINiER, 

11560 J 3, REFNN DISPLAY ALL REFERENCES TO THE VARIABLES S) NAHLl! M , 

U570 r IF NN IS ONLY 1 CHAR? BLANK IS ASSUMED FOR THE SLCONTA 

11580 \ NN HAY NOT BE MORE THAN 2 CHARS AND MUST NOT HAUL A lYF'L SUTT1X, 

11590 i 4, REFSSSSS DISPLAY ALL REFERENCES TO THE INTEGER SSSSS WHERE 

U600 ', SSSSS IS A 1-5 DECIMAL DIGIT * BETWEEN AND 9999V, 

11610 i HEXIDECIHAL OR OCTAL REFERENCES WITHIN THE TEXT ARE NOT LIS i ED, 

11620 } 5, REF*NN 

11630 ? 6. REF$NN 

11640 I 7, REF1SSSSS 

11650 } 8. REFtSSSSS 

U660 J ?, REF DISPLAY THE NEXT TEXT LINE CONTAINING AT LEAST ONE 

11670 » REFERENCE TO THE VARIABLE OR NUMBLF; SPECIFIED BY THE LAST 

H6S0 i REFNN OR REFSSSSS COMMAND LXECUlEU. IF NO HONE REFERENCINC 

11690 i TEXT LINES? 'TEXT END' WILL BE DISPLAYED, 

H700 } IF 'REF' ENTERED ALAIN* THE FIRST REFERENCING TEXT LINE 

11710 } WILL BE LISTED, 

H720 i REMEMBRANCE OF THE LAST VARIABLE NAME? NUMBER OR POSH ON 

H730 « WITHIN THE TEXT LS USUALLY (BUT NOT ALWAYS 5 LOST WHEN ANT 

U740 ? COMMAND INVOLVING DOS IS EXECUTED, 

11750 } 

11760 v PRESS BREAK TO PAUSE? ENTER 10 CONlINUL, 

11770 ^FORMATS 5 8 ARE THE SAME AS 1 AND 2? EXCEPT LIST ING/PRIN i INC STARTS WiTH 

11730 ?THE SPECIFIED VARIABLE NAME OR DECIMAL NUMBER? IF IT EXISTS? UK THE NEXT 

11790 .HIGHER EXISTING NAME OR NUMBER? IF NOT, 

11800 ? 

11810 r IF 'SYS12/SYS' NOT IN THE SYSTEM WHEN COMMAND 'REP' EXECUTED? BASIC ERROR 

11820 } 'UNPRINTABLE ERROR' (CODE 38 DECIMAL) WILL BE INUGKED, CHB"E n WILL DISPLAY 

11830 I 'FILE NOT IN DIRECTORY' 

11840 } 

11850 * 

11860 SW 046 mmtmwmmmmmmmmmm**m 

11870 i 

11880 ?NEW SYSTEH MODULE 'SYS11/SYS' ALLOWS THE FOLLOWING BASIC COMMAND? 

11890 i 

11900 I 1, RENUM U SEARCHES TEXT TOR UNDEFINED SEGUENCE NUMBERS AND 

119io i FOR SOME ERRORS ASSOCIATED WITH BASIC STATEMENTS THAT USE 

11920 J SEGUENCE NUMBERS, ERRORS ARE INDICATED*. 

11930 I SSSSS/U THERE IS NO TEXT LINE SSSSS, 

11940 J SSSSS/X - TEXT LINE SSSSS HAS SYNTAX ERROR, 

U950 I SSSSS/S - TEXT LINE SSSSS HAS A BAD SEQUENCE *, 

11960 i TEXT IS NOT ALTERED IN ANY WAY. 

11970 J 

11,980 J 2, RENUM SSSSS f 1 1 1 II * PPPF'P jQ&SGQtt -- CAUSE ALL TEXl LINES WHOSE 

H990 } SEG i'S ARE >- PPPPP AND <-- GGGGG TO BE ASSIGNED NEW SEQ *'S. 

12Q00 J SSSSS IS THE. FIRS I NEW SEG * ASSIGNED WITH SUBSEQUENT *'S 

12010 } GENERATED BY ADDING II1II TO THE SEG i OP THE PREVIOUS TEXT LINE. 

12020 » SSSSS AND I II II HOST BE IN THE RANGE 1 - 65529 AND HAVE 

12030 5 DEFAULT VALUE 10. PPPPP MUST DE IN THE RANGE I - 65529? 

12040 J HAS DEFAULT VALUE AND MUST DE <- SSSSS, 

12050 j Q8QGQ MUST BE IN THE RANGE 1.-65529? >- SSSSS? AND HAS DEFAULT 

12060 f VALUE 65529, 

12070 i 

12080 J COMMANDS USING THE DEFAULTS ARE; 

12090 ? RENUM ? 



12100 
12110 
12120 
12130 
12140 
12150 
12160 
12170 
12180 
12190 
12200 
12210 
12220 

i i.uy 

12240 

12250 

12260 

12270 

12280 

12290 

12300 

12310 

12320 

1234 

12350 

12360 

12370 

12380 

12390 

12400 

12410 

12420 

12430 

12440 

12450 

1246.0 

12470 

12480 

12490 

12500 

12510 

12520 

12530 

12540 

1255G 

12560 

1257Q 

12580 

1259Q 

12600 

12610 



RENUH 


c c-c •::■•-■ 

U U -_J :.J •_„! 


RENUH 


flllll 


RENUH 


mPPPPP 


RENUH 


5 ? sCGQQQ 


RENUM 


cc-cce , T 1 T T f 


RENUH 


r- r- r- r-- n p r*' T 1 D r< 
uu-jijj.5 n IT i i 


RENUH 


'IIIIIjPPPPP 


RENUH 


CCCCC' . . „ fifjAfiC' 


RENUH 


jIIIII. >GGGGG 


RENUH 


fsPPPPPjQQQGG 


RENUH 


SSSSSf HIIlsPPPPP 


RENUH 


coct- c . t t r t t . , nnnf in 


RENUH 


CKcc - . t'ppnp . nfinnfi 



RENUH jUIIIfPF'F'F'F'jQQGGQ 

IF ANY ERROR. ENCOUNTERED BEFORE ItX" 
TO ' RENUH U' AND DISPLAYS ALL ERRORS 
IF AN ERROR ENC0UNFED AFTER TEXT 
TEXT NOW BAD' IS DISPLAYED AND A 
t0 'DOS READY'. "OR TO DEBUG (If CW 
THE BASIC TEXT HUB! NOT BE RECLAIMED 



IS bLIEREDj THE COm-iAND KL< 
IT CAN FIND* 

NATION BEGINS^ 'FATAL ERROR, 
EXIT TAKEN? GOING EITHER 

;'_ " } , 

iUUi\" i UoE DtiCjIL n- } » 



Sll/SYS' NOT IN TFIE SYSTEM WHEN L OH HAND 'RENUH' IS EXECUTED? 
ERROR 'UNPRINTABLE ERROR'CCCDE 38 DECIMAL) WILL 
JKEDj WITH CHB ! 'E" DISPLAYING 'FILE NOT IN DIRECTORY' » 



I IF 'SY 
J BASIC 
?BE INVC 



04/ 



? BASIC IS ALTERED TO ALL0U Li E OR D IN PLACE O 

^RESPECTIVELY WHEN EACH IS ALL OF THE FOLLOWING! 

} 1. 1ST CHAR OF INPUT LINE, 

5 2, FOLLOWED BY EITHER A PERIOD OR 

I 3. THE INPUT LINE DOES NO! CON IAIN 



2 * 4- tfr {) A Q * ^ * 4" * 4- * -4- * 4 * * "4 * -4' 4 *■■ "4 -•£- "4" 4" 4-" 4" '4- 



EiU i UK DELL IE 



DECIMAL DIGIT ■. 
N : * 



PROGRAM BISKDUHF'/BAS HAS BEEN UPG 



1. 



RADED TO 
PRINTF 



OPTION OF SENDING DUMP TO 

OPTION OF DUMPING BY DISK RELATIVE 
LOGICAL RECORD * WITHIN FILE 
RETURN (ASC CODE 13 DECIMAL 5 



ALLOW; 

R OR DISPLAY, 



SEC "(OR WITHIN FILE OR 
RECORDS END WITH CARRIAGE 
EACH OCCURENCE OF THIS CHAR 



IS TREATED 



CM 



EOR REGARDLESS OF OTHER SPECIAL MEANINGS 



(IE? WITHIN A GUOTE 
A DUMP PAUSE COMMAND, 



* & * A A O + * * * * * * * * -4" 4- * 4" 4 4- * 4 -4- \ 



RING OR PRECEDED BY A DOWN- ARROW 



0, iU-JV 

12640 
12650 
1266Q 
12670 
12680 
12690 



: 'R0GRAH LDTASH/CMD HAS BEEN UPGRADED TOt 

1, READ SOURCE FROM DISK AS WELL AS CASSETTE, 

2, WRITE SOURCE AND/OR OBJECT TO DISK AS WELL 



FILES 



i Ui'w 

TO 



WRITTEN. 



DISK 



PIER ALL SEC 

3, ALLOW 'DQUN--ARROU' SCROLLING TO DISPLAY UP 

4, PREVENT THE CONFUSING PRINTER OUTPUT ASSOCIATED WITH 'DEfH' 
ONLY THE 1ST BYTE OF ASSOCIATED OBJECT CODE IS LISTED. 
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12700 f 5, LIST SYMBOLS IN ALPHABETICAL ORDER WITH REFERENCE LIST. 

12710 i 6, ACCEPTS AND CONVERTS LOWER CASE ALPHA iG UPPER, 

127 20 f 

12730 ? SUPPLEMENTAL INSTRUCTIONS FOR THE. EDITOR ASSLFiBLLR, 

12740 j 

12750 ? 1, 10 LOAD A SOURCE MODULE INTO IHL TEX! Dili I LR , 

12760 ? 1. L D- NNNNNNMN/riT,F'PPPP'RPP?D IF SOURCE IRON BibK, 

12770 f 2, L 'PNNNNNN IF SOURCE f RON CASSETiE, 

12780 5 IF THE I EXT BUFFER ALREADY CONTAINS TEXi? TILL QUERY "lEXi IN 

12790 I BUFFER, ARE YOU CONCATENATING??!" APPEARS, REPLY ! W IP NO 1. * 

12800 ?' CAUSING BUFFER 10 BE SET EMPTY BEFORE HLU HODULL LOAD, 

1281.0 ? REPLY 'Y' IF YOU ARE.! CAUSING TIE NEW SOURCE TO BE APPENDED UN i G 

12820 I THE END OF THE OLD. NO CONCERN IS SHOWN FOR OVERLAPPING bEu i? 

12830 y THEREFORE YOU SHOULD EXECUTE AN 'IP EBTASM CGHHAND UPON CUMPLEilON 

12840 ? OF THE LOAD TO ASSURE A VALID SET Or ASCENDING SEQUENCE NLPiDLEC, 

12850 i 

12860 ? 3. TO STORE A SOURCE MODULE, 

12870 ? 1* W II : NNNMNNMN/TTT,PPPPPPPF,D If SOURCE COINS TO DISK, 

12880 « 2, W T>N.NNNNN if SOURCE COINS TO CASSLuL 

12890 ? 

12900 I 4, FOR A COMMANDS Will! 'NO' OPTION NOT SPECIFIED* RESPOND TO NIL 

12910 I QUERY "OBJECT PILE TO DISK OR TAPES' REPLY D OR IT"! 

12920 ? 1. T IF OBJECT COINS TO CASSLTIL- NAME WILL UOML FRliH 

12930 ? THE A COMMAND- 

12940 f 2: D if OBJECT COINS TU DISC- RCSPUiSB ;U ii.L UuLki 

12950 I "ODJEC1 !■ I.LESPLi/P' WIN; N !L NNRNNNNN/ ; Pi , PI PPPPPFN 

12960 ! f 1LESPEC OF NIL OBjEU MODULE, Nil. f iLL WILL DE 

12970 ? OFF NEC iiUiF D1A i ELY ••■ DU i NOf UP ill EN UNilL END Or 

12980 s ASSENDf V i.J 81 .! NO, liiL Nf ,; N. IN flit. (■, COMMAN:.: io 

12990 ? IGNORED < 

13000 >- 5, WHEN AN OUTPUT SOURCE OR OBJECT f ILL \M UPCNEiJs DHL Of Hit 

13010 5 FOLLOW INC IS [ll SPLAYED 1 

13020 5 1. "FILE ALREADY EXISTS, USE. ir????'\ REPLY 'Y' it 

13030 f THIS IS YOUR IMTENPION, OTHERWISE REPLY 'BREAK' 10 

13040 J TERMINATE THE W OR A COMMAND, 

13050 ? 2, "ttttttntttUU F FEE NON EXISTENT , REPLY "C" TO 

13060 ? CREATE IT", REPLY "'FN IF THIS 18 YOUR 1NIEN1ION. 

13070 ? OTHERWISE REPLY y DRLAK y TO TERMINATE THE W OP A LOHMANLU 

-\ij)0() ■;. 

13090 i 6, DUE TO AN ERROR IN THE ORIGINAL DOS* EDTASH RUNS WITH 

13100 j INTERRUPTS DISABLED (EXCEPT WHEN RE LNABI ED BY DISR I/O) IN ORDLR 

13110 ? THAT USE. OF 'BREAK' WILE f UNCI ION PROPERLY, 

131.20 I 7, THIS EDTASH CAN EXECUTE IN A REGULAR IPC DOS ENVIRONMENT, 

13130 \ 8, THIS EBTASM REQUIRES A TRSUOS LIKE OPERATING SYSTEM? ANli USES 

131.40 > LEVEL LI KEYBOARD? DISPLAY AND PRINTER RUUPENES AND CON 1 HOI BLOCKS, 

13150 ? USERS ALTERING THE SYSTEM BEUAREMM 

13160 i 

13170 ; 

13180 **** 050 #***««;«:*******.***:*«:*:*•*•« lUtttttUtU titttUiUt 

13190 ,- 

13200 ? BAGICL/CMD IS A MODIFIED VERSION OF THE. UPiC.iNA!. LEVEL I BASIC, 

13210 ?' THIS MODULE LOADS FROM DISK INTO SE0O- 7FFFFP AND CAN FUNCTION AS LEVEL 1 

13220 ? FOR LEVEL I BASIC PROGRAMS THAT EXECUTE FN A REGULAR LEVEL I COMPUTER 

13230 5 WHERE "MEM SIZE" IS SPECIFIED AS 28160 ( 6E0OH > OR LESS, IIOWLVLKs DUE TO 

13240 JTHE WIDE VARIETY OF LEVEL L BASIC PROGRAMS? APPARAT DOES NOT GUARANTEE THE 

13250 i OPERATION OF ANY OF THEN VIA BASLC1/CMD, 

V Inl Q 'i 

13270 5THE FOLLOWING COMMANDS ARE ADDED TO LEVEL I J 

13280 I I, CSAVE* THIS CAUSES THE. PROGRAM TEXT TO BE MOVED INTO MAIN 

13290 i MEMORY AT S00OH AND UP? RATHER THAN SENT TO THE 
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13300 i CASSETTE. 'RESET' AND THEN DOS COMMAND 'LV1BSKSP 

13310 \ WITH THE ' S' OPTION WILL STORE THE LEVEL 1 PROGRAM ' 

13320 J LQCATEB IN THE 0000- UP REGION ONTO BISK. 

13340 ? 2, CLQAB* FIRST* EXECUTE DOS COnnANO 'LV1DSKSL' WITH 'L' OFT ION 

13350 i THE SPECIFIED LEVEL I PROGRAM WILL BE LQABLB FROM 

13360 ! BISK INTO MAIN MEMORY BEGINNING AT 8000H. AT i HE 

13370 ? CONCLUSION OF I HIS LOAD? BOS COMMAND 'LEVEL!' WILL 

13380 5 AUTOMATICALLY BE EXECUTEBs THUS BRING UP LEVEL 1, 

13390 y ISSUING LEVEL I COMMAND 'CLGAB*:' WILL CAUSE THE 

13400 r LEVEL I TEXT BUFFER TO BE LOADED FROM MAIN HENDRY 

13410 ? AT 8000H? RATHER THAN FROM CASSETTE. 

13420 ? 3, CSAVE$3$ A JUMP IS TAKEN TO LOCATION TO CAUSE A POWER ON 

13430 I LEVEL II START UP? BUT WITHOUT LOSING HIE CONiLNiS 

13440 I OF MEMORY. THIS IS INTENDED AS AN AID TO THE 

13450 i NON-DISK USER WHERE 'RESET'' IN A SYSTEM W1HIDUI 

13460 I THE EXPANSION INTERFACE LEAVES THE USER STILL IN 

13470 f LEVEL I. RESPONDING MEN SIZE ~ 20 160 OR LESS 

13480 i WILL PRESERVE LEVEL I IN MEMORY FOR SUySLGUENT 

13490 « STARTUP VIA: 

13500 5 1. 'SYSTEM' 

13510 i 2. V2S160' 

13530 J 

13540 i 

13550 lUt 051 ^mmmtmmsmmmmmm^mmfm 

13560 >• 

13570 i 'LV1DSKSL' THIS OBJECT MODULE PROVIDES AN INTERFACE BETWEEN LLVLL-I 

13580 JEXECUTING-IN-LEVEL-II AND THE LEVEL I BASIC PROGRAMS STORED ON BISK. 

13590 } 

13600 I TO THE GUEEY "REPLY "S" FOR SAVEt "L" FOR LOAD."* REPLY "S" IF A LEVEL 1 

13610 5 BASIC PROGRAM IS IN MAIN MEMORY AT 800 OH AS A RESULT OF A 'CSAVEr LEVEL I 

13620 I COMMAND SUCCESSFUL EXECUTION* AND IT IS TO BE STORED ON BISK. REPLY "L" 

13630 S IF AN EXISTING LEVEL I PROGRAM ON BISK IS TO BE LOADED INTO MAIN MEMORY 

13640 J AT 8000IP LEVEL I ACTIVATED VIA BOS COMHANB 'LEVEL!' s AND THE PROGRAM TO 

13650 J LOADED INTO LEVEL PS TEXT BUFFER BY A SUBSEQUENT 'CLQABr ISSUED BY THE 

13660 i USER. 

13670 5 

13680 {RESPOND TO THE GUERY "FILE- SPEC" WITH THE FILESPEC THE LEVEL I BASIC TEXT 

13690 i MODULE HAS OR IS TO HAVE. 

13700 » 

13710 J IF "BAB TEXT PREFIX" DISPLAYED. ONE OF THE FOLLOWING EXISTS? 

13720 ? 1. TEXT FROM BISK IS NOT A LEVEL I BASIC TEXT MODULE. 

13730 J 2. MAIN MEMORY IS NOT GOOD. 

13740 5 3. USER FORGOT TO EXECUTE 'CSAVEr . 

13750 i 

13760 5 END. 
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00100 j'DISASSEH' VERSION 1,1 

00110 J 

00120 } THIS DISASSEMBLER DISASSEMBLES 2-80 CPU CODE* AND IS DESIGNED ID RUN ON 

00130 I THE TRS--80 DOS SYSTEM USING AS SOURCE EITHER A STANDARD IRS SO LUAD MODULE 

00140 J ON DISK OR A PREVIOUSLY LOADED OBJECT MODULE IN MAIN MEMORY, 

00150 I DISASSEMBLER WRITTEN IN 2-80 CODE 

00160 J 

00170 } OPERATION 

00180 ? 

00190 {ENTER DOS COMMAND 'DISASSEH' 

00200 I 

00210 5 RESPONSES TO QUERY 'OBJECT FROM MAIN MEMORY OR BISK"! 

00220 j 1* NULL - SAME AS 'IP 

00230 j 2, 'D' - OBJECT IS A DISK LOAD MODULE 

00240 I 1, RLSPONSE 10 QUERY 'FILESPEC? 

00250 ? 1, FILESPEC IN '" HNNNMNNN/T i T ,PPPPFPPP ID' FORMAT 

00260 ', 2, RESPONSE TO QUERY 'OFFSET OBJECT VIRTUAL ADDRESSES BY (HEX)'? 

00270 I l.NULL - = 

00280 , 2, 'NNNN' -- I. 10 4 HEX DIET! VALUE WHICH WHEN ADDED iO LOAD 

00290 I ADDRESSES WITHIN THE LOAD MODULE WILL LIVE PROPER ADDRESS 

00300 I WHERE I HE CURRENT INST BEING DISASSEMBLED WOULD BE DURING 

00310 ? NORMAL EXECUTION DP THAT (.TIDE, 

00320 I THIS PARAMETER IS MELDED WHEN A OBJECT MODULE LOADS 1 ONE 

00330 ? PLACE IN MAIN MEMORY? BUT ACTUALLY EXECUTES FROM ANOTHER* 

00340 I WRAP-AROUND lb ALLOWED, 

00350 I EXAMPLE t IF THE OBJECT MODULE LOADS INTO COOO FFFf BU I IS 

00360 I TO EXECUTE IN 7000 AFP! - t APPLYING AN OUSEi CD B000 WILL 

00370 i CAUSE THE DISASSEMBLER TO DISASSEMBLE AS IF i HE LOAD 

003SO } WAS ACTUALLY DONE TO 7000 MFfF, 

00390 I 

004OO 5 3. RESPONSE TO QUERY 'VIRTUAL RESTART LOCATION (HLX)' 

00410 i 1, NULL = NUNE 

00420 j 2, 'NNNN' - 1 TO 4 HEX DIGIT VIRTUAL RESTART LOCATION, 

00430 i ALLOWS RESTART OF A LARGE DISASSEMBLY WITHIN THE INSTRUCTION 

00440 I ' PRINT PORTION OF THE LISTING, 'NNNN' IS THE LISTED LOG OF ANT 

00450 5 INSTRUCTION OP THE DISASSEMBLY? USUALLY CHOSEN AS THE LOCATION 

00460 i VALUE PRINTED FOR THE FIRST INST ON THE PAGE WHERE PRINTING 

00470 J WAS INTERRUPTED, 

00480 J 

004 90 i 3, 'M' - OBJECT IS IN MAIN HEMURY 

00500 i 1, RESPONSE TO QUERY 'OBJECT VIRTUAL BASE ADDRESS (HEX)'? 

00510 1 1, 'NNNN' 1 TO 4 HEX DIGIT LOCATION VALUE WHERE THE 

00520 5 OBJECT CODE IS CONSIDERED TO EXECUTE FROM, IN THE LISTING* 

00530 ? THIS VALUE WILL BE THE FIRST INSTRUCTION PRINTED' S LOCATION 

00540 J VALUE, 

00550 i 2, RESPONSE TO QUERY 'OBJECT REAL BASE ADDRESS (HEX)'? 

00560 J 1, HULL REAL LOCATION SAME AS VIRTUAL 

00570 I 2, 'NNNN' I TO 4 HEX DIGIT MEMORY LOCATION WHERE THE 

00580 I DISASSEHBLER WILL ACTUALLY FIND THE OBJECT CODE, 

00590 I 

006O0 i 

00610 {RESPONSES TO QUERY 'OUTPUT TO PRINTER'? 

00620 ', 1, 'Y' OUTPUT IS TO LINE PRINTER, ALL LINES 0- 64 CHARS, 

00630 i 1, RESPONSE TO REQUEST 'REPLY 'ENTER' WHEN PRINTER AT TOP OP PAGE'? 

00640 5 1. NULL SET PRINTER EXACTLY AT TOP OF PAGE, THIS PROGRAM ASSUMES 

00650 J 66 LINES/PAGE AND LEAVES THE TOP 3 AND BOTTOM 3 LINES BLANK 

00660 I ON EVERY PAGE, 

00670 } 2, IF OBJECT FROM MAIN MEMORY? RESPOND TO OUERY 'BYTE COUNT (HEX)'? 

00680 5 1, 'NNNN' 1 TO 4 HEX DIGIT COUNT OF BYTES TO 

00690 ? DISASSEMBLE 
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00700 J 

00710 I 2, NULL - SAME AS 'M' 

00720 I 3, 'N' - LISTINGS WILL GO TO DISPLAY, If OBJECT f ROM DISK* THE LOCATION 

00730 ,* TABLE WILL NOT BE LISTED* 

0074O 5 1. RESPONSES TO QUERY 'NORMAL DISPLAY PAUSES'? 

00750 J 1, MULL - SAHE AS 'Y' 

00760 } 2, 'Y' ~ DURING DISASSEMBLED INSTRUCTION LISTING? THE PROGRAM WILL 

0077ft i PAUSE AT THE END Of EACH DISPLAY PAGE, TO CONTINUE UN TO THE 

00780 ', NEXT PAGE? HIT 'ENTER'. A REPLY Of 'X' WILL TERMINATE: THE 

00790 ? DISASSEMBLY, 

0030Q ! 3. 'W THE DISASSEMBLY WILL DISPLAY AS EAST AS IHE PROGRAM 

00310 i CAN HOBBLE, TO PAUSE. i HIT ' f " . TO CONTINUE AFTER PAUSE? 

00820 I HIT 'ENTER' , 

00830 5 

00840 J RESPONSES TO QUERY 'ANY OPTIONS'?, (OBJECT PROM DISK. ONLY) 

00850 i 1, NULL - NO HORE OPTIONS 

00860 J 2, 'NIP' - DO NOT PRINT OR DISPLAY THE DISASSEMBLED INSTRUCTIONS, I HIS DUES 

0OS70 i NOT AFFECT THE DISPLAY Of IHE LOCATION CROSS-REFERENCE PASS, 

00380 i 3, 'RTD' - LOCATION REFERENCE TABLE IS 10 BE STORED ON DISK, 

00890 s AFTER THE LOCATION--CFCGSS- REFERENCE PASS? THE PROGRAM WILL QUERY 

00900 } 'REFERENCE TABLE FILESPELC? RESPOND WITH THE FILESPEC IN 

00910 J NNNNNNNM/TTTSPPPPPPPPtB fORHAT IDENTIFYING IHE FILE TO CONTAIN I HE 

00920 1 REFERENCE TABLE, REFERENCE TABLE FILES ON DISK CAN BE USED (BY 

00930 J USER-CREATED PROGRAM) TO MERGE THE REFERENCE FABLES OF I WO OR MURE 

00940 i PROGRAMS, SEE BELOW FOR FILE FORMAT, 

00950 i 4, 'REft' - ENABLE LISTING OF ALL TYPES OF REFERENCES? IS IKE DEFAULT CONDITION, 

00960 i 5, 'REC ENABLE LISTING OF THE SPECIFIED REFERENCE TYPE WHERE £ IS ONE OF 

00970 s Ls Pj R? S? T? U< V; W OR X, REFERENCE TYPES ARE DEFINED AT THE 

009SO 5 BEGINNING OF EACH LOCATION TABLE LISiING, 

00990 ? 6, ' R I A •' - DISABLE LIST OF ALL TYPES OF REFERENCES 

01000 i 7, 'RIC - DISABLE LISTING OF THE SPECIFIED REFERENCE TYPE WHERE & IS ONE OF 

01010 5 L? P. R? S? T. Ur Vy W OR X, 

01020 ? 

01030 ', 

01040 I 

01050 5 THE DISASSEMBLER OPERATES IN THESE PHASES: 

01060 5 I, (OBJECT FROM DISK) BUILD LOCATION REFERENCE I ABLE. IF INSUFFICIENT 

01070 I MEMORY AVAILABLE* 'INSUFFICIENT MEMORY' WILL BE PRINTED AND THE 

01080 ? DISASSEMBLY TERMINATED. 

01090 i DURING THIS PHASE* THE OBJECT MODULE WILL BE DISASSEMBLED TO OB IAIN 

01100 « REFERENCE INFORMATION AND WILL DISPLAY THIS PASS WITHOUT PAUSE, 

OHIO J 2, WRITE REFERENCE TABLE FILE, (RTD OPTION ONLY) 

01120 i 3, LIST DISASSEMBLED INSTRUCTIONS, IF SPEC ED? DISPLAY PAUSES WILL OCCUR, 

01130 ? 4, PRINT LOCATION REFERENCE TABLE, (OBJECT FROM DISK ONLY AND PRINTER 

01140 s USE SPEC ED) 

01150 I 

01160 ? IF THE DOS OPERATING SYSTEM RETURNS AN ERROR CODE; ' && DISK ERROR' MSG iS 

01170 5 DISPLAYED AND THE DISASSEMBLY TERMINATED, &iL IS A TWO HEX DIGIT ERROR CODE, 

01 ISO i SOME OF THESE CODES AREt 

OU90 i 1C OR ID - EOF (OBJECT NOT A LOAD MODULE ?????> 

0120O J 25 OBJECT IS READ- PROTECTED 

0121O J IB NO MORE SPACE ON DISKETTE 

01220 ', 19 OBJECT IS PASSWORD PROTECTED 

01230 J 18 OBJECT FILE DOES NOT EXIST 

01240 r 

01250 5 'DISK OBJECT FILE FORMAT NOT AS EXPECTED' MSG WILL BE DISPLAYED IF i HE 

01260 ^DISASSEMBLER FINDS SOMETHING WRONG WITH TF1E OBJECT MODULE, 

01280 ; WHILE INSTRUCTION DISPLAYING OR PRINTING IS IN PROGRESS* HOLDING; DOWN I HE 'X' 

01290 i OR THE '?' KEY WILL CAUSE DISASSEMBLY TERMINATION UR PAUSE RESPECTIVELY. 
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01300 J HIT THE 'ENTER' KEY TO CONTINUE. AFTER PAUSE. 

01310 i 

01320 ^SUFFIXED TO LACH REFERENCING LOCATION VALUE IS A REFERENCE I YPE LODL (DEFINED 

01330 J AT TOP OF EACH REFERENCE LISTING) GIVING THE TYPE OF Z- SO INSTRUCTION MAKING 

01340 fTHE REFERENCE, 

01350 I 

01360 JON THE DISASSEMBLED INSTRUCTION PRINT LINES; 

01370 J i, COLUMN 1 INDICATES THE NUMBER OF REFERENCES TO BYTES OF THE INST RUCTION, 

01380 J VALUE IS IIEXIBECIHAL WITH BLANK = AND F MEANS 15 OK MORE REFERENCES, 

01390 I 2, COLUMN 2 INDICATES WHICH BYTES OF "lilt INSTRUCTION HAVE BEEN REFERENCED 

01400 i IF BLANK AND COLUMN 1 NON-BLANK t THEN ONLY THE INS V S iS] BYTE REFERENCED 

01410 I OTHERWISE THE HEX DIGIT REPRESENTS A 4 BIT BINARY MASK OF WHICH 

01420 } BYTES* FROM THE LEFT » ARE REFERENCED. 

01430 5 

0144 i 

01450 J PROGRAM WARRANTY IS LIMITED TO HIE PROVISION ON EITHER BISK OR TAPE ( SELLER' S 

01460 ^DISCRETION) AN OPERATIONAL LOAD MODULE TO RUN UNDER TKS-80 BOS 1,1 

01470 ?THERE IS NO WARRANTY FOR CONTINUED OPERATION UNDER SUBSEQUENT BOS KELLASEb, 

01480 t 

01490 i THIS PROGRAM LOADS INTO 8200. THEN SHIFTS ITSELF !0 0200 f OR EXECUTION, 

01500 JENTRY POINT - 9B0 0H, 

01510 ? 

01520 ?TO LOAD THIS MODULE FROM TAPE TO DISK? USE TRS-80'S 'TAPEDISK' F'ROCRwH, 

01530 ?NAME ON TAPE IS 'DISASH' 

01540 JNAME ON DISK IS ' DISASSEM/CMD' 

01550 ? 

01560 ? 

01570 5 FORMAT OF REFERENCE TABLE FILE CREATED BY 'RTD' OPTION; 

01580 J i, 1 BYTE r COH, BACKWARD EOF, IGNORE II, 

01590 j 2, 1 OR MORE ENTRIES OF THE FOEHi 

01600 I I, 'LOCATION' LOW VALUE BY IE 

01610 ? 2, 'LOCATION' NIGH VALUE DYlE 

01620 ? 3, CONTROL BYTEs PITS 7-0 (7 IS LEF I MOST ) 

01630 ? 7-6 - lit DUMMY LAST ENTRY IN TABLE, ICNORE ALL UIFIER 

01640 j BITS ANC BYTES OF ENTRY, 

01650 i 7-6 r oil PEFERENLEE EN IKY; 

01660 I 1, BUS - 0, 

01670 I 2, ' LOCATION' REFERENCED BY THE ONE OR MORE 

01680 ? FOLLOWING REFERENCOR EN FRIES, 

01690 J 7-6 ■ 00; REFLRENCuR ENTRY; 

01700 i 1, THE INS! RUCTION Ai THIS 'LOCATION' REFERENCED 

0171O I 'LOCATION' IN THE PREVIOUS REFERENCEE ENTRY 

01720 I 2, BITS 5-0 - 00 IFF! CODE INDICATING TYPE OF 

01730 I INSTRUCTION MAKING THE REFERENCE; 

01740 I 

01750 J 

01760 ? 

01770 J 

017S0 J 

01790 i 

01800 ? 6-7 UNUSED 

01310 i 

01820 » 

01830 f 

01840 ? B--1F UNUSED 

01850 i SEE A REFERENCE TABLE LISTING FOR DEF INI I IONS, 

01 860 r END, 
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OFFSET VERSION 1,1 
H RESIDES IN 5200-5FFF ♦ 



M-.\it . pRFRPAK rUHCilOMS AS FOLLOWS? 

iuW^h : L. Rt-Ai'S E L ! liLR A TAPE- TYPE ASSEMBLY LOAD MODULE FROM I APE OR A DISK-TYPE 

ooi Ao i ASSEnBLf LOAD MODULE FROM DISK 

00 ..;.': :: 1, IF SOURCE FROM DISK? PROGRAM ASKS FOR SOURCE FILESPEC IN 

o.,;;;0 i DDDDDDDD/TT1 ,PPPPPPPP;D FORMAT 

ZjJ : '■ "* *" I'/aREA INTO WHICH HODULE WILL LOAD UHEN WRITTEN TO DISK. 

■ ;! . ;': : 2. POSSIBLE CONFLICTS WITH SYSTEM STORAGE, 

{,r,-y?i) ; 3. HODULE ENTRY POINT. IF APPENDAGE HAS BEEN APPLIED? THE 

; y ; v,/, '; ENTRY POINT WILL BE INTO IHE 15 BYTE APPENDAGE, 

»„?i,; ; A t ASKS FOR NEW LOAD POINT, REPLY EITHER WITH NEW LOAD POINT OR SIMPLY 

{ii)r-,,\ i REPLY 'ENTER' IF SATISFIED WITH CURRENT LOAD POlNl, 

002-60 5 4. IF NEW LOAD POINT SPEC ED? DIFFERENT FROM THE ORIGINAL LOAD POINT* 

002 n> i THE PROGRAM ASKS IF THE 

W»i< ', APPENDAGE IS TO BE SUPPRESSED, IF SO, THE RESULTING MODULE CAN 

/jA2v:i ; f iNj v BE USED MIA DOS 'LOAD' COMMAND AS THERE IS NO APPENDAGE TO 

.WvU . MiiUF THE PROGRAM TO ITS EXECUTION AREA, RESULTING OUTPUT LOAD 

.y.\i.'. ;: HnuillE CAN BE USED VIA 'LOAD' WHERE TWO OR HORE LOAD MODULES ARE 

LOADED INIO MAIN MEMORf AND THEN STORED AS ONE LOAD HODULE MIA 'DUMP', 

IF NEU LOAD POINT SPEC ED? GO BACK TO $2 ABOVE, 

IF AT LEAST ONE NEW LOAD POINT SPEC ED AND APPENDAGE NOT SUPPRESSED* 

•■.0.*.!j» : PRCGRAH ASKS IF INTERRUPTS 

Oi,.: f .>-. ARE TO BE DISABLED, IF REPLY = 'Y' PROGRAM INSERTS A 'DC (DISABLE 

y;XVO i INTERRUPTS INSTRUCTION) INTO THE APPENDAGE AS ITS ONLY AlTEMPT TO 

oO-OiO ; PREVENT INTERRUPTS FROM OCCURRING, 

ft.O'^-o :- /■ ASKS FOR FILESPEC OF DISK-TYPE LOAD MODULE TO BE CREATED, REPLY WITH 

■-,0 '.:•)-:» , F ILESFEG IN NNNNNNNN/TTT.PPPPPPPPiD FORMAT. 

(!■■)■; iCs j 8. WRITES THE HEW DISK-TYPE LOAD MODULE TO DISK, IF A NEW LOAD POINT 

' IT T; * 

i HE' LOAD ADDRESS FOR EACH OBJECT CODE RECORD IS ALTERED, 

i,iUAu , 2. IF APPENDAGE HOT SUPPRESSED? AN EXTRA OBJECT CODE RECORD 
fl(!-,f.O i (CALLED IHE APPENDAGE) IS INSERTED 

oO^O ;: BEFORE THE ENTRY POINT RECORD, 

/>;V70 i 3, THE ENTRY POINT FOR THE MODULE BECOMES: 
;,!>~M •■ 1. IF APPENDAGE SUPPRESSED? ENTRY POINT = OOOOH. 

•;O.Va j ?,. OTHERWISE ENTRY POINT IS TO FIRST BYTE OF APPENDAGE. 






v ■•.' ■-.' a. ■: 



IF THE HODULE LOAD POINT HAS BEEN CHANGED AND APPENDAGE HOT SUPPRESSED? 



00520 ? THE MODULE IS EXTENDED BY A 15 



0y5-.vJ f 1m i 



APPENDAGE WHICH IS EXECUTED WHEN CONTROL IS PASSED TO THE MODULE ENTRY 



005-0 i piilNT, THE APPENDAGE EXECUTION IS AS FOLLOWS; 

0055O i C EXECUFES A DISABLE INTERRUPTS INSTRUCTION? IF SPEC ED WHEN APPENDAGE 

005.00 ; CREATED. 

.vv.^/u = 2. MOVES THE OBJECT CODE. (LESS THE APPENDAGE) FROM THE 'NEW LOAD 

00=;hO i AREA TO THE 'OLD' LOAD AREA, 

002.V0 > 3, i 'ASSES EXECUTION CONTROL TO THE 'OLD' ENTRY POINT 

0OS0( 



OOiSJ 
0".--.!'V./ 



THIS PROGRAM DOES NO f PERFORM ANY OBJECT CODE RELOCA i ION ! ! ! i 
IT fiNlY MOVES CODE TO NEW LOAD LOCATIONS (APPLYING THE APPENDAGE) SO THAI DOS 
FAN LFAD THE MODULE FROM DISK AND PASS CONTROL TO IT. IF THE PROGRAM EXECUTES 
FROM DOS CONFLICTING AREA? IT MUST BE CAREFUL NOT TO RE-ENABLE THE INTERRUPTS. 



IF 



TLir: en lid re r-c-f 



JGRAM LOADS INTO THE DISPLAY AREA (3C00-3FFF) WITHOUT OVERFLOWING 



00670 ? IT? THOsi' OBJECT" CODE RECORDS WILL NOT HAVE THEIR LOAD ADDRESSES MODIFED. 
17^1 M00O-51FF MEMORY IS DOS, ANY PARI OF THE TARGET PROGRAM EXECUTING FROM THERE 
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00700 

00710 

00720 

00730 

00740 

00750 

00760 

00770 

00780 

00790 

00800 

00310 

00320 

00830 

00840 

00350 

00360 

00870 

00330 

00890 

00 900 
00910 
00920 
00930 
00940 
00950 
00960 
00970 
00930 
00990 
01000 
01010 
01020 
01030 
01040 
01050 
01060 
01070 
01080 
01090 
01100 
OHIO 
01120 
01130 
01140 
01150 
01160 
01170 

01 ISO 
01190 
01200 
01210 
01220 
01230 
01240 
01250 
01260 
01270 
01230 
01290 



I WILL CAUSE DOS AND/OR TARGET PROGRAM MALFUNCT ION, 

j 

J5200--6FFF MEMORY IS WHERE DOS COMMANDS EXECUTE ERGM, YOUR BOS FUNCTIONS- USING 
f PROGRAM MAY HAVE ITS LOAD POINT IN THIS REGION AND DOS WILL LOAD AND EXECUTE 
?THE PROGRAM AS A COMMAND* BUT THE DOS COMMAND 'LOAD' WILL REJECT THE MODULE, 

f7000-FFFF» NO PROBLEMS* OTHER THAN LACK OF RAH? f OR PROGRAM LOADING IN THIS AREA, 

5 

SWARMING!!!!! !! 

?FGR EACH TIME A GIVEN LOAD MODULE IS USED AS THE INE'tii SOURCE AND A NEW LOAD 

J POINT IS SPECIFIED? AN ADDITIONAL APPENDAGE IS APPENDED* 

? THIS PROGRAM KNOWS AND CARES NOTHING ABOUT PREVIOUSLY EXIST INC ARPEMlUiGRS, 

* DURING SOURCE READ? THIS PROGRAM LOADS THE OBJECT MODULE INlU A CONTROL TABLE 

STARTING AT LOCATION 6000!!, (VIEWABLE VIA 'DEBUG' 5, 

5IF THE OBJECT MODULE IS i RON DISK* THE DATA STORE:!* IN THE SABLE 

? IS EXACTLY THAT FOUND ON DISK, IF THE OBJECT MODULE IS FROM TARE? IT IS CONVERTED 

I TO DISK OBJECT MODULE FORMAT WHEN STORED IN THE JABLL. illL I ABLE HAS IHE 

t FOLLOWING LOGICAL RECORD FORMATS: 

? 1, OBJECT CODE RECORD, 

I 1* ID - 01 

i 2, 1 BYTE COUNT OF OBJECT BYTES i2, (0 2 ■ 256 250) 

I 3,2 BYTE LOAD ADDRESS 

? 4, OBJECT BYTES 

i 2, ENTRY POINT RECORD, 

J 1. IB = 02 

; 2, 02H BYTE COUNT 

I 3, 2 BYTE ENTRY ADDRESS 

I 3, COMMENT RECORD, 

I 1,1 BYTE ID, 

i 1, ID = OR 3 

i 2, ID = OR 3 

; 2, 1 BYTE COMMENT BYTE COUNT, - 256, 

i 3, COMMENT BYTES 

', 4, (TAPE INPUT ONLY) EXTRANEOUS FREE IX BYTLS REG, THIS REG CONTAINS ALL 

i DATA BYTES ENCOUNTERED ON THE TAPE BEFORE THE 'U' (55H) ID BY i E 

I ENCOUNTERED, 

; 1, ID - Ff , 

? 2, 2 BYTE LENGTH COUNl 

3, EXTRANEOUS BYFES 

5, (TAPE INPUT ONLY) NAME RECORD, CONTAINS ALL BYTES ! : ROM THE 'U' SYNCH 
BYTE TO EITHER A 3CH BYTE (ID FOR TAPE OBJECT CODE RECS ) OR A 7SH 
BYTE (ID FOR TAPE ENTRY POINT REC ) ENCOUNTERED, 

1, ID ~ FE, 

2, 2 BYTE LENGTH COUNl 

3, NAME BYTES 

6, (TAPE INPUT ONLY) IMBEDDED EXTRANEOUS DATA REC, CONTAINS EXTRANEOUS DATA 
J APPEARING BETWEEN END OF ONE OBJECT CODE REC AND EITHER i HE NEXl 

l OBJECT CODE RECORD OR THE ENTRY POINT RECORD, 

I K ID • F'Li, 

{ 2, 2 BYTE LENGTH COUNT, 

y 3, EXTRANEOUS DATA BYTLS 

> 7, (TAPE INPUT ONLY) BAD CHECKSUM RECORD, FOLLOWS AN OBJECT CODE RECORD 

; WHOSE CHECKSUM COMPUTED BAB, 

? 1 , ID - PC, 

J 2,1 BYTE CHECKSUM FROM TAPE, 

i 3,1 BYTE COMPUTED CHLCKSUH DURING OBJECT RECORD READ, 

} DURING READ FROM TAPE! 

5 1, SINGLE '*' DISPLAYED WHEN READY FOR TAPE, DO REWIND (IF NECESSARY)? FAST 



FE IF MODULE E ROM DISK 
FB IE MODULE FROM TARE 



- 30 - 

01300 i FORWARD POSITIONING (IF NECESSARY) AND 'PLAY'. 

0131ft i 2, '«r APPEARS WHEN TAPE READ SYNCHRONIZATION HAS COMPLETED, 

01320 J 3, ALTERNATES '%' AND BLANK IN RIGHT-HOST DISPLAY POSITION AS EACH OBJECT 

01330 5 RECORD READ COMPLETES WITH GOOD CHECKSUM, 

01340 J 4, DISPLAYS 'C WHEN ft BAH CHECKSUM ENCOUNTERED , 

01350 i 5, DISPLAYS 'P' IF LEADING EXTRANEOUS DATA BYlES ENCOUNTERED, 

01360 I 6, DISPLAYS ''I' IF IMBEDDED EXTRANEOUS DATA BYTES ENCOUNTERED, 

01370 ? 

01380 ? END, 

00100 J 

00110 5 

00120 ? 

00130 f 

00140 ? 

00150 I 

00160 i 

DOCUMENT AT I ON FOR APR A RAT 'SUPEEZAP' 2,0 

*tttt WARNING PROGRAM MALFUNCTIONS IF ANY WRITE OPERATIONS 

A T T E M P T E D "10 A W P I T L ■ P R 'I E C T E D D I S K E I "( E ♦ 1 1 & 1 1 * 1 1 1 1 1 

FUNCTION MUi' DISPLAYS A DISK SECTOR, lUNCIION MRP DISPLAYS A 
MODULO 256 BYTE BLOCK OF MAIN MEMORY RESPECTIVELY. 

FOR 'DO' ■■ TOE ERROR CODE RETURNED BY THE SYSTEM IS DISP! AYED 

IN COLUMN 7 OF THE LAST LINE, I!' - 6v THE READ WAS SUCCESSFUL 
BUT THE SECTOR IS RE AD PROTECT ED (IEv NOT READABLE BY NORMAL 
USER DISK OPERATIONS > BUI WAS READ BY SUF'ERXAP), 

FOR 'DD' AND 'PD' FUNIC! IONS? COLUMNS 16 ARE DEFINED? 
1 - RELATIVE DISK NUMBER (0-3), 

2 3 -■■ RELATIVE TRACK NUMBER (HEX • 22), 

4 •• RELATIVE SECTOR NUMOER ON TRACK (0 9), 

5-6 RELATIVE POSITION MIFX) WITHIN THE SEC! OR. 

WHEN A 'DD' SECTOR OR A ' IRE BLOCK IS DISPLAYED ON THE SCREEN <■• 
THE PROGRAM IS CONSTANT LY MONT TURING THE INPUT KEYS LOOKING 
FOR ONE OF THE FOLLOWING COMMANDS: 

' X ' T E R M I N A T E T H EL P E I M A R Y F U N C T I U N , _ e .,.,...., ; ...... . 

'R' - DISPLAY AGAIN THE. SAME SECT OR/ BLOCK 



\ 



M' OR ' ? ' - SCROi E FORWARD ONE SECT OR/BLOCK , C •.-'■"•• '. 

' ' OR ' = ' - SCROLL BACKWARD ONE SECTOR/BLOCK, 

'J' - RESTART THE SAME PRIMARY FUNCTION, ( Lw e t> m 

'K' 'DO' ONLY, SAME AS MR EXCEPT NEXT SECTOR FROM 

SAME DRIVE AS PREVIOUS DISPLAYED SECTOR, 
'MOD&&' - MODIFY THE CURRENT SE f OR /BLOCK. CM IS THE 

RELATIVE POSITION WITHIN THE. SEC TOR /BLOCK OF 

BYTE TO BE MODIFIED (FIFX 00 - i' I ) , 

THE PROGRAM RESPONDS BY PLACING AN 'M' IN 
COLUMN 7 OF THE MODIFICATION LINE, FURTHER 
IT PRECEDES THE HEX DIGIT QUAD CONTAINING 
THE NEXT HEX DIGIT TO BE CHANGED WITH AN 
INDICATOR OF WHICH DIGIT IT IS* USING 

'+' , ' M '#' AND ' /' FOR THE IS'M 

2ND* 3RD AND 4TH DIGITS OF THE GUAD 
RESPECTIVELY, 

RESPONSES WHILE IN 'MODIFICATION MODE' AREJ 

HEX DIGIT - F - REPLACES CURRENT DIGIT AND 

ADVANCES TO NEXT DIGIT , 



ssf f. 
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'DM' REPLACEMENTS ARE. FOR REAL, 'DD' 
REPLACEMENTS ARE BUI- KtlRE D UNTIL EITHER 
AN ENTER OR A Mr COMMAND, 

WHEN THE LAST DIGIT lLi.bE!. AYED iS REPLACED* 
NEXT POSITION INCREMENT WRAPS AROUND TO THE 
FIRST DIGIT* BUT NO FURTHER DIbPi RRI'LACR- 
HENTS ARE ACCECPTED UNTIL AFTER 
A NON-HEX-DIGIT KEY IS PRESSED* 

SPACE - CURRENT DIGIT IS NOT CHANCED AND 
POSITION IS ADVANCED 1 DIGIT, 

RIGHT-ARROW - SAME AS ' SPACE' ♦ 

SHIFT-LEFT ARROW - CURRENT DIGIT NOT CHANCED 

AND POSITION IS RETARDED 4 DIGITS, 
LEFT-ARROW - CURRENT DIGIT NOT CHANGED 

AND POSITION IS RETARDED I DIGIT, 
SHIFT- RIGHT-ARROW - CURRENT DIG! t NO I CHnNGED 

AND POSITION IS ADVANCED A DIGITS, 
UP ARROW - CURRENT DIGIT NOT CHANGED AND 

POSITION IS RETARDED 1 LINE, 

FIRST LINE WRAPS 10 LAST , 
DOWN- ARROW - CURREN i I'LI G.l i NOT UIANCE U 

AND POSITION ADVANCED 1 LINE, 

LAST LINE WRAPS TO F 1RST , 

'Q' - PUD' ONLY), CANCELS WRITE 01 UPDATED 
SECTOR, TERMINATES 'MODIFICATION MODE', 

ENTER - T E R M I HATES ' M D I F' I CAT 1 N M (J D E ' , F E 

'DD'» THE UPDATED SECTOR IS WRI'LiE N BACK 

TO DISK, 

SCOPY' - ('DIP ON! Y) MOVE THE DISPLAYED bLCTOE 

TO A DISK LOCATION TO BE SPECIFIED, 

THE USER WILL BE ASKED TO 

RESPOND 'Y' OR 'N' AS TO THE TO- BE READ PROTECT 

STATE OF THE DESTINATION SECTOR, 



FUNCTIONS 'FTP AND ' PM' SEND THE DISPLAYED BLOCKS 10 THE 
PRINTER, 

TO HALT PRINTER ACTION? HOLD DOWN THE 'IP KEY UNTIL THE PRINTER 
STOPS, THIS ACTION TERMINATES I HE FUNCTION, 

FOR PRINTER OPERATIONS YOU MUST SPECIFY A BYTE COUN'KFOR 'PM') 
OR A SECTOR COUNT (LOR 'FTP ) SO PROGRAM WILL KNOW WHEN TO STOP 
PRINTING, 

THE 'ZERO DISK. SECTORS' PUNCT ION DOES JUST THAT!!!!!! 

IF A SECTOR BEING ZEROED IS READ-PROTECTED. HIE USER IS 
ASKED (REPLY 'Y' OR ' N' ) IF HE WANTS THAT SECTOR TO REMAIN 
READ-PROTECTED, 

'COPY DISK SECTORS' FUNCTION COPIES THE SPECIFIED SECTORS TO 
NEW DISK LOCATIONS* DUFM.ICATI NG INTO THE NEW LOCATIONS THE 
READ -PROTECT STATUS OF I HE OLD, 



NORMALLY , THE COPY PROCEEDS IN ASCENDING IRACK/SECTOR # ORDER, 



66380 j THE RIGHT, LEFT.. UP, AND DOWN ARROWS WAV BE USED TO 

06490 ; ALTER POSITION 14 1 THIN SECTOR NITHOUT CHflHGIMG CONTENTS 

06580 i 13. TO ALTER THE CURRENT HEX DIGIT, S IMPLY DEPRESS THE KEY 

06600 ; FOR THE IBI VALUE, 6-9, fl-F THE UPDATE POSITION HILL BE 

06790 ; AUTOMATICALLY ADVANCED 1 HEX DIGIT POSITION 

66860 ; 14 TYPE IN ALL THE HEM HEX DIGIT VALUES. 

66900 i 15. IF HOT SATISFIED WITH THE CHANGES TO THE SECTOR, PRESS Q 

07000 i . TO CANCEL THE MODIFICATION AND TO REDISPLAY THE SECTOR. 

07100 ; 16. WHEN SATISFIED WITH THE CHANGES TO THE SECTOR, PRESS ENTER, 

07200 ; AND WHEN INSTRUCTED, PRESS ENTER AGAIN. 

07306 ; THE NEW SECTOR CONTENTS WILL BE DISPLAYED. 

67400 ; 17. WHEN A SECTOR IS DISPLAYED AfID YOU ARE HOT IN I10DBB STATE 

07566 ; 1 PRESS J IF YOU WISH TO DISPLAY ANOTHER SECTOR CTO 

07680 ; STEP 6 ABOVE) 

•"07700-1 r~ "t- TO MODIFY TO CURRENT SECTOR, GO TO STEP 12 ABOVE. 

0788O ; 1,8. TO EXIT SUPERZAP, PRESS BREAK 

0790O ; 19 RUN BASIC PROGRAM 'SOPERZAF/COM IF YOU WISH TO KNOW MORE 

080O0 ; OF SUFERZAP'S OPERATION 

88100 ; • 

08260 ; 

08380 ; 

68400 ; 

0850O ;ALL MANDATORY ZAPS ARE DATED AS TO THE DATE APPARAT INCORPORATED THE 

086GO ,ZAP INTO MODULES BEING SUBSEQUENTLY SHIPPED. 

087OO ; 

088OO , 

08980 ,ALL OPTIONAL ZAPS ARE DATED AS TO WHEN THE CHANGE BECAME AVAILABLE 

09086 ; 

0910O ; SOME EARLY PRE-RELEASE COPIES OF NEW DOS DO HOT HAVE THESE ZAPS IN 

09260 ;THE EXACT LOCATIONS 

093G8 ; 

09400 j BEFORE MAKING ANY PART OF A ZAP, BACKUP YOUR NEWDOS. AND' THEN VERIFY THAT' 

69580 ; ALL PARTS OF THE ZAP ARE MAKEABLE. 

69608 ; 

09780 ;**«*#*****++*« ZAP 601 *++++++* 03/16/79 *:m+**4*m-* 

09800 , 

09980 ; MANDATORY ZAP TO INCREASE TRACK FORMATING TOLERANCE IN FULL DISKETTE 'COPY'' 

10080 , 

10160 :DISK 0120U0 = START OF SYS3/SYS FILE / 

16200 j CHANGE DISK 0123F7 CONTENT'S FRUH TE4938' TO 'FE2738 -J 

10380 ; 

10400 .; 

10500 i 

10600 ;***#*•+++** ZAP 002 ++++*+++» 03/16/79 ++++-.m*t-**.M: 

10700 ; 

18888 ; OPTIONAL ZAP TO DISABLE THE EFFECTS OF CHANGE 11618 (SEE NEWDOS DOCUMENTATION) 

18986 i TO ALLOW LOWER CASE LETTERS '.KEYED IN AS UPPER) TO APPEAR IN BASIC DIRECT OR 

11888 ; TEXT STATEMENTS PLEASE NOTE THAT CHANGE 1018 OF NEWDOS NEVER DID AFFECT 

11108 ,DATA INPUT VIA 'INPUT'' OR TtJKEYt 

11200 ; 

11380 ; DISK 083568 = START OF FILE 'BAS1C/CMD' 

11406 ; CHANGE DISK 60356C CONTENTS FROM 'C30052C3' TO C33360L 

11580 ; 

11660 ; 

11768 , 

11808 i *****++++■+ ZAP 003 *:m:n#m 03/23/79 i-H:.tm*H:mmi 

11980 i 

12608 , MANDATORY ZAP TO HALE NEWDOS BASIC FUNCTION 'REF WORK FRuPERLV WITH FIELD' 

12160 ; 

12200 ,DISK 022588 = STAR1 OF FILE 3V:L_ Sri , 

12308 , CHANGE DISK 022779 CONTENTS Fhull ZOi.577 TO ,,02n7, : 

12460 , CHANGE DISK ii2/i"'.;8 LUMEN TO if' il /U04FL iu TOuCCFITO 

1.5U!' [HnfuTO TO' r l uTOTO .. OlTOTO: ,'. . Z o.l ] .il iu . is! ?> 



12668 ; CHANGE DISK 622?fiti CONTENTS FROM '2887EB' TO '28F6EB / 

12708 ; CHANGE DISK 8227A2 CONTENTS FROM '1864FE' TO '18EDFE''</ 

12800 i CHANGE DISK 6227B2 CONTENTS FROM 'DA154F' TO 'DA6E4FV\ 

12900 , CHANGE DISK 8227D1 CONTENTS FROM 'iaE:F79' TO 1SB379"/ 

12000 ; 

lilOO ; 

12200 , 

liiOO ;*******++* ZAP 004 *++****+*:+ 04/O2/79 +:t:+H:(i +++++++t::^* 

13408 ; . 

12580 ; MANDATORY ZAP TO CORRECT LOADER FILE ACCESS DENIED ERRORS FOR 

12686 .EXECUTE ONLY ATTRIBUTED MODULES. 

13700 ; 

13860 ; disk 000588 = start of file svso/svs 
13960 ; change disk 0q14ee conten'is from 
14860 ; c9 13 1a ib e6 87 fe 07 38 87 2e 25 b7 c9 06 80 oo ed 
• 141001 •— to ■■■ 

14200 i C9 62 6B 22 7E E6 07 FE 8? 28 84 2E 25 B7 C9 CB 96 ED 
14380 ; 
14400 ; 
145O0 ; • 

14608 ;******+*+* ZAP 885 Mm-m** 04/02/79 +*«*+++*«.*:««+ 

14780 i . 

14888 j MflNDflTORV ZAP TO ALLON COPY'' TO WORK WITH PASSWORDS ENABLED 

14988 ; 

150OO /THIS CHANGE CHANGES THE 17-2GTH BYTES OF FILE 'COPY/CHD'S FPDE (THE UPDATE 

15108 ,AND ACCESS PASSWORD ENCODES THIS FPDE EXISTS SOMEWHERE IN TRACK 11 HEX, 

15288 /RELATIVE SECTORS 2-9 THE FOLLOWING DISK ADDRESS IS ONLY WHERE THE CHANGE 

15388 ; TAKES PLACE FOR A PARTICULAR SYSTEM YOUR: LOCATION ON THE DISKETTE MAY 

15488 ;BE DIFFERENT BUT THE CHANGE IS THE SAME 

15588 ; 

15608 ; CHANGE DISK 6112D0 CONTENTS FROM 

15786 / EB 29 21 OE 

158O0 ; TO 

15968 / 81 20 96 42 s/ 

16006 ; 

16188 ; 

16266 ; 

16268 ;********** ZAP 866 a********** 84/63/79 **»*+++++ mw 

16486 ; 

16566 ; OPTIONAL ZAP TO PERMANENTLY DISABLE 'DEBOUNCE'.. E! 1 MI MATING NEED TO 

16660 ,HOl:D SHIFT-UP-ARROW DURING RESET/POWER ON. 

16788 ; 

16800 ;DISK 008566 = START OF FILE 'SVSO/SVS' 

16980 .; CHANGE DISK 6615F1 CONTENTS FROM 

17600 ; 09 28 66 I 

17108 ; TO fl 

17280 ; 09 18 66 

17368 ; 

17468 ; 

175O0 ; 

17686 ;«*+**++*+ ZAP 807 ««»:(. Mf; 04/62/79 t+ *•+++■(*( «++*+++.+ 

177O0 ; 

17808 ; MANDATORY ZAP TO CORRECT CMD"XX" MALFUNCTION WHEN INSUFFICIENT FREE MEMORY 

17986 ; AVAILABLE TO SAVE BASIC'S DATA.. 

18060 ; 

18108 j DISK O03500 = START OF FILE 'BAS1C/CMD' , 

18268 ; CHANGE DISK 00387A CONTENTS FROM 'DA 7 A 19 Di' TO 'DA -D 55 D1V 

18386 ; CHANGE DISK 662887 C0N1ENTS FROM D2 7A 19 El' I'U 'D2 '.< 55 El J 

18480 /CHANGE DISK 66294.1 CUNIENTS FROM 

18506 ; 57 5A C3 9A 5B Ci 99 5B C3 t.5 5B C3 84 57 

1.8668 , TO 

18706 . 57 21 7A 19 E5 01 08 61 C5 C5 CI F7 54 57-/ 

18860 ; 



Supplemental Instructions for 
Editor-Assembler 1.1 
For Disk Operations 

1. Load the editor-assembler from disk via the DOS command: EDTASM 

2. To load a source modttle into the text buffer, 

1. L D=nnnnnnnn/ttt.pppppppp:d if source from disk 

2. L T=sinnnnn if source from tape 

K 
When an L command is issued and previous text exists in the buffer, normal editor- 
assembler operations assume the user wants to concatenate the new source onto the 
end of the old. However, under the modifications, i > £ ikn b uhlul 1~ Ji o m diul * , 
the query "TEST IN BUFFER. ARE YOU CffiICATENATING????"/. ap Rllp^y N if text buffer 
is to be cleared before the load or Y if concatenation is to occur. If concate- 
nation is done, either from tape or disk, an N command should be issued after 
the L command conclusion to assure a valid set of ascending sequence numbers, 

3. To store a source module: 

1. W D==nnnnnnnn/ttt.pppppppp:d if source is to go to disk 

2. V T=nnnnnn if source is to go to tape 

4o For A commands with NO option not specified: 

1. Respond to the query "OBJECT FILE TO DISK OR TAPE? REPLY D OR T" 

1. T if object to go to tape. Name will come from the A command. 

2. D if object to go to disk. Respond to query "OBJECT FILESPEG?" 

with the nnnnnnnn/ttt.pppppppp:d filespec of the object 
module. The file will be opened immediately, but not written 
until end of assembly listing. The name in the A command 
is ignored. 



